Linux

12min
This instruction assumes the following Passwork location — /var/www/
Preparation
Before upgrading, if Passwork is installed in a cloud/virtual environment, create a snapshot of the virtual state of the OS to restore functionality in case of an incorrect upgrade;
Obtain root permissions:
shell
sudo -i
sudo -i
﻿
Obtaining the latest version of the Passwork
Create a temporary directory to receive the Passwork:
shell
mkdir /tmp/update_passwork
mkdir /tmp/update_passwork
﻿
You need to go to the Passwork customer portal, copy the certificate number and get Passwork version 7 through the address bar of your browser — https://portal.passwork.pro/api/version?rc=yes&apikey=certificate_number
Go to the Passwork customer portal and copy the API key to get the current version:
﻿
Create an API_KEY variable with the certificate number:
shell
API_KEY=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
API_KEY=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
﻿
Get version 7 of Passwork using the prompt:
shell
curl -o "/tmp/update_passwork/passwork.zip" "https://portal.passwork.pro/api/download?rc=yes&apikey=$API_KEY"
curl -o "/tmp/update_passwork/passwork.zip" "https://portal.passwork.pro/api/download?rc=yes&apikey=$API_KEY"
﻿
Clear the API_KEY variable with the certificate number:
shell
unset API_KEY
unset API_KEY
﻿
Update to the latest version
Get the current version of Passwork into a variable:
shell
# Get Passwork version from the version file
version=$(cat /var/www/version)
# Get Passwork version from the version file
version=$(cat /var/www/version)
﻿
Copy the Passwork configuration files to a temporary directory:
shell
cp /var/www/init/config.env /tmp/update_passwork/
cp /var/www/init/encryption_key /tmp/update_passwork/
cp /var/www/init/config.env /tmp/update_passwork/
cp /var/www/init/encryption_key /tmp/update_passwork/
﻿
Create an archive of the current version of Passwork to be able to roll back to a previous version:
shell
# Install zip if an error occurs during execution
apt install zip -y
yum install zip -y

zip -r /var/passwork-$version.zip /var/www/*
# Install zip if an error occurs during execution
apt install zip -y
yum install zip -y

zip -r /var/passwork-$version.zip /var/www/*
﻿
Delete all contents from the Passwork directory:
shell
rm -rf /var/www/* && rm -rf /var/www/.*
rm -rf /var/www/* && rm -rf /var/www/.*
﻿
Unzip Passwork version 7 to a physical location:
shell
unzip /tmp/update_passwork/passwork.zip -d /var/www/
unzip /tmp/update_passwork/passwork.zip -d /var/www/
﻿
Move the copied Passwork configuration files to the new version:
shell
mv /tmp/update_passwork/config.env /var/www/init/
mv /tmp/update_passwork/encryption_key /var/www/init/
mv /tmp/update_passwork/config.env /var/www/init/
mv /tmp/update_passwork/encryption_key /var/www/init/
﻿
Delete the update_passwork temporary directory:
shell
rm -rf /tmp/update_passwork
rm -rf /tmp/update_passwork
﻿
Set permissions for the physical location of the Passwork:
DEB
RPM
find /var/www/ -type d -exec chmod 755 {} \;
find /var/www/ -type f -exec chmod 644 {} \;
chown -R www-data:www-data /var/www/
find /var/www/ -type d -exec chmod 755 {} \;
find /var/www/ -type f -exec chmod 644 {} \;
chown -R www-data:www-data /var/www/
﻿
Restart the web server and PHP:
DEB
RPM
systemctl restart php8.3-fpm.service apache2.service
systemctl restart php8.3-fpm.service apache2.service
﻿
Clear Passwork temporary cache:
DEB
RPM
sudo -u www-data bash -c 'cd /var/www && php -d memory_limit=-1 ./bin/console cache:clear'
sudo -u www-data bash -c 'cd /var/www && php -d memory_limit=-1 ./bin/console cache:clear'
﻿
Perform a cache warmup:
DEB
RPM
sudo -u www-data bash -c 'cd /var/www && php -d memory_limit=-1 ./bin/console cache:warmup'
sudo -u www-data bash -c 'cd /var/www && php -d memory_limit=-1 ./bin/console cache:warmup'
﻿
Go to the Passwork root location and update the Passwork version in the database:
DEB
RPM
sudo -u www-data bash -c 'cd /var/www && php -d memory_limit=-1 ./bin/console app:update'
sudo -u www-data bash -c 'cd /var/www && php -d memory_limit=-1 ./bin/console app:update'
﻿
﻿
Updated 11 Mar 2025
Did this page help you?
Windows Server
SSO settings