Windows Server

12min
Please note:
This instruction assumes the following:
The physical location of Passwork is — C:\inetpub\wwwroot\passwork
The name of the Passwork website is — Passwork Web Site
Before updating, if Passwork is installed in a cloud/virtual environment, create a snapshot of the virtual OS state to restore functionality in case of an incorrect update.
Obtaining the latest version of the Passwork
Create a temporary directory to receive the Passwork:
PowerShell
mkdir C:\inetpub\new_version
mkdir C:\inetpub\new_version
﻿
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:
PowerShell
$API_KEY = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
$API_KEY = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
﻿
Get version 7 of Passwork using the prompt:
PowerShell
try {
    (New-Object System.Net.WebClient).DownloadFile(
        "https://portal.passwork.pro/api/download?rc=yes&apikey=$API_KEY",
        "C:\inetpub\new_version\passwork.zip"
    )
    Write-Output "The Passwork archive was successfully retrieved"
} catch {
    Write-Output "Error receiving Passwork: $_"
}
try {
    (New-Object System.Net.WebClient).DownloadFile(
        "https://portal.passwork.pro/api/download?rc=yes&apikey=$API_KEY",
        "C:\inetpub\new_version\passwork.zip"
    )
    Write-Output "The Passwork archive was successfully retrieved"
} catch {
    Write-Output "Error receiving Passwork: $_"
}
﻿
Clear the API_KEY variable with the certificate number:
PowerShell
Remove-Variable API_KEY
Remove-Variable API_KEY
﻿
Update to the latest version
Get the current version of Passwork into a variable:
PowerShell
$version = Get-Content "$env:SystemDrive\inetpub\wwwroot\passwork\version"
$version = Get-Content "$env:SystemDrive\inetpub\wwwroot\passwork\version"
﻿
Copy the Passwork configuration files to a temporary directory:
PowerShell
Copy-Item -Path "C:\inetpub\wwwroot\passwork\init\config.env" -Destination "C:\inetpub\new_version\" -Recurse -Force
Copy-Item -Path "C:\inetpub\wwwroot\passwork\init\encryption_key" -Destination "C:\inetpub\new_version\" -Recurse -Force
Copy-Item -Path "C:\inetpub\wwwroot\passwork\init\config.env" -Destination "C:\inetpub\new_version\" -Recurse -Force
Copy-Item -Path "C:\inetpub\wwwroot\passwork\init\encryption_key" -Destination "C:\inetpub\new_version\" -Recurse -Force
﻿
Create an archive of the current version of Passwork to be able to roll back to a previous version:
PowerShell
Compress-Archive -Path "C:\inetpub\wwwroot\passwork\*" -DestinationPath "C:\inetpub\wwwroot\passwork-$version.zip" -Force
Compress-Archive -Path "C:\inetpub\wwwroot\passwork\*" -DestinationPath "C:\inetpub\wwwroot\passwork-$version.zip" -Force
﻿
Delete all contents from the Passwork directory:
PowerShell
Remove-Item -Path "C:\inetpub\wwwroot\passwork\*" -Recurse -Force
Remove-Item -Path "C:\inetpub\wwwroot\passwork\*" -Recurse -Force
﻿
Unzip Passwork version 7 to a physical location:
PowerShell
Expand-Archive -Path "C:\inetpub\new_version\passwork.zip" -DestinationPath "C:\inetpub\wwwroot\passwork\"
Expand-Archive -Path "C:\inetpub\new_version\passwork.zip" -DestinationPath "C:\inetpub\wwwroot\passwork\"
﻿
Move the copied Passwork configuration files to the new version:
PowerShell
Copy-Item -Path "C:\inetpub\new_version\config.env" -Destination "C:\inetpub\wwwroot\passwork\init\" -Recurse -Force
Copy-Item -Path "C:\inetpub\new_version\encryption_key" -Destination "C:\inetpub\wwwroot\passwork\init\" -Recurse -Force
Copy-Item -Path "C:\inetpub\new_version\config.env" -Destination "C:\inetpub\wwwroot\passwork\init\" -Recurse -Force
Copy-Item -Path "C:\inetpub\new_version\encryption_key" -Destination "C:\inetpub\wwwroot\passwork\init\" -Recurse -Force
﻿
Delete the new_version temporary directory:
PowerShell
Remove-Item -Path "C:\inetpub\new_version" -Recurse -Force
Remove-Item -Path "C:\inetpub\new_version" -Recurse -Force
﻿
Set permissions for the physical location of the Passwork:
PowerShell
Invoke-Expression "icacls '$env:SystemDrive\inetpub\wwwroot' /grant 'IIS_IUSRS:(OI)(CI)`M'"
Invoke-Expression "icacls '$env:SystemDrive\inetpub\wwwroot' /grant 'Users:(OI)(CI)`M'"
Invoke-Expression "icacls '$env:SystemDrive\inetpub\wwwroot' /grant 'IUSR:(OI)(CI)`M'"
Invoke-Expression "icacls '$env:SystemDrive\inetpub\wwwroot' /grant 'IIS_IUSRS:(OI)(CI)`M'"
Invoke-Expression "icacls '$env:SystemDrive\inetpub\wwwroot' /grant 'Users:(OI)(CI)`M'"
Invoke-Expression "icacls '$env:SystemDrive\inetpub\wwwroot' /grant 'IUSR:(OI)(CI)`M'"
﻿
Download the web.config rewrite rules and place them in the new Passwork version — C:\inetpub\wwwroot\passwork\public\web.config
web.config
﻿
PHP registration and extension activation
Import IIS modules and register the PHP version:
PowerShell
Import-Module IISAdministration
Add-PsSnapin PHPManagerSnapin

New-PHPVersion -ScriptProcessor "$env:ProgramFiles\php8.3\php-cgi.exe" -SiteName "Passwork Web Site" -VirtualPath "/"
Import-Module IISAdministration
Add-PsSnapin PHPManagerSnapin

New-PHPVersion -ScriptProcessor "$env:ProgramFiles\php8.3\php-cgi.exe" -SiteName "Passwork Web Site" -VirtualPath "/"
﻿
Activate PHP extensions for the Passwork website:
PowerShell
$extensions = @(
    "php_curl.dll",
    "php_gd.dll",
    "php_gettext.dll",
    "php_intl.dll",
    "php_ldap.dll",
    "php_mbstring.dll",
    "php_mongodb.dll",
    "php_mysqli.dll",
    "php_opcache.dll",
    "php_openssl.dll",
    "php_pdo_pgsql.dll",
    "php_pdo_sqlite.dll",
    "php_pgsql.dll",
    "php_soap.dll",
    "php_zip.dll",
    "php_fileinfo.dll"
)

foreach ($extension in $extensions) {
    Write-Host "PHP extension activated: $extension"
    Set-PHPExtension -Name $extension -Status Enabled -SiteName "Passwork Web Site" -VirtualPath "/"
}
$extensions = @(
    "php_curl.dll",
    "php_gd.dll",
    "php_gettext.dll",
    "php_intl.dll",
    "php_ldap.dll",
    "php_mbstring.dll",
    "php_mongodb.dll",
    "php_mysqli.dll",
    "php_opcache.dll",
    "php_openssl.dll",
    "php_pdo_pgsql.dll",
    "php_pdo_sqlite.dll",
    "php_pgsql.dll",
    "php_soap.dll",
    "php_zip.dll",
    "php_fileinfo.dll"
)

foreach ($extension in $extensions) {
    Write-Host "PHP extension activated: $extension"
    Set-PHPExtension -Name $extension -Status Enabled -SiteName "Passwork Web Site" -VirtualPath "/"
}
﻿
Activate additional PHP methods for the Passwork website:
PowerShell
$phpVersion=(Get-PHPConfiguration -SiteName "Passwork Web Site" -VirtualPath "/").Version
Set-WebConfigurationProperty -PSPath "IIS:\Sites\Passwork Web Site" -Filter "system.webServer/handlers/add[@name='php-$phpVersion']" -Name "verb" -Value "GET,HEAD,POST,PUT,DELETE,PATCH"
$phpVersion=(Get-PHPConfiguration -SiteName "Passwork Web Site" -VirtualPath "/").Version
Set-WebConfigurationProperty -PSPath "IIS:\Sites\Passwork Web Site" -Filter "system.webServer/handlers/add[@name='php-$phpVersion']" -Name "verb" -Value "GET,HEAD,POST,PUT,DELETE,PATCH"
﻿
Go to the Passwork root location and update the Passwork version in the database:
PowerShell
cd "C:\inetpub\wwwroot\passwork"
php -d "memory_limit=-1" .\bin\console cache:warmup
php -d "memory_limit=-1" .\bin\console app:update
cd "C:\inetpub\wwwroot\passwork"
php -d "memory_limit=-1" .\bin\console cache:warmup
php -d "memory_limit=-1" .\bin\console app:update
﻿
﻿
Updated 10 Mar 2025
Did this page help you?
Windows Server (PowerShell)
Linux