Minimum system requirements

Passwork is not resource-demanding, and the number of required servers depends on the number of active users, the amount of data stored and the system fault tolerance requirements.

See our technical requirements.

Preparing the environment for offline installation

Before installing Passwork, you need to get the components and module, then use Install-Passwork -Method offline -v 6, which will do the installation.

Obtain the following components and move them to Windows Server:

• PowerShell module
• Passwork Code
• MongoDB
• Administration utilities
• PHP
• IIS components

Then open PowerShell as "Administrator":

Using the Start context menu

1. Right-click on the Start icon in the lower left corner of the screen.
2. Select "Windows PowerShell (Administrator)" from the context menu.

Using the Start menu

1. Left-click on the Start icon in the lower left corner of the screen.
2. Write powershell
3. Open PowerShell as "Administrator" with the combination — Ctrl + Shift + Enter

And unzip the PowerShell module to the default directory:

PowerShell

# Get the location of PowerShell modules
$windowsModulePaths = $env:PSModulePath -split ";" | Where-Object { $_ -like "C:\Windows*" }

# Unzip the PowerShell module to the directory
Expand-Archive `
    -Path "$pwd\PassworkModule.zip" `
    -DestinationPath $windowsModulePaths -Force

Create directory for components and archives:

PowerShell

if (-not (Test-Path "$pwd\passwork_component" -PathType Container)) {
    New-Item -Path "$pwd\passwork_component" -ItemType Directory
    Write-Host "Directory successfully created" -ForegroundColor Green
} else {
    Write-Host "Directory already exists"
}

Move components and archives to passwork_component. The file location structure should look as follows:

PowerShell

$pwd\passwork_component\
        database_tools_latest.zip
        iis_package_latest.zip
        mongodb_database_latest.msi
        Passwork-xxxxxx.zip
        php_latest.zip

Installation

Run the offline installation of Passwork:

PowerShell

Install-Passwork -Method offline -v 6

Actions performed by the script

• Checking the operating system version
• Prepare and install MongoDB
• Checking the availability of administration utilities
• Installing administration utilities
• Preparing archive with Passwerk code
• Checking PHP archive
• PHP configuration
• Checking and installing IIS with additional extensions
• Unzipping Passwork code
• Web server setup with Passwork website creation
• Setting up a Passwork website in conjunction with PHP

The script will perform a user rights check and install and configure the components. If errors occur, the PowerShell shell will display the errors:

Once complete, the address to connect to Passwork via a web browser will be displayed. This is what a successful installation looks like:

Setup wizard

Once installed and configured, Passwork will be available at https://your_servername

warning

By default, Passwork uses a self-signed certificate that is automatically generated during installation, so the first time you open the page you will see a message saying that the browser does not trust the certificate of the site.

Choose language

As the first step, the system will offer to choose the interface language:

System parameters check

The checklist of parameters will show if all necessary components are installed on your server:

Database connection

You must use the default MongoDB address to connect:

Encryption key

Passwork will generate a new key for server encryption. If Passwork is connecting to an existing database, specify the encryption key to be used.

danger

Please use a key generated by Passwork. Using keys generated by third-party tools may cause errors.

License keys

You can download the license keys in your Passwork Customer Portal or request them from your managers.

Setting up your own SSL certificate

By default, Passwork generates a self-signed certificate. After installation, you can switch to using full SSL certificates.

Use your own certificate

• For certificates issued by a trusted issuer.
• For certificates issued by domain certification authorities of your organization.

Open "Server Manager" → "Tools" → "Internet Information Services (IIS) Manager" → "Server Certificates" → and click "Import":

After importing, go to the Passwork website, open "Bindings" and select the imported web certificate for the HTTPS protocol:

Configure background tasks

Background tasks are tasks that are executed by the scheduler in the background. For example, LDAP synchronisation, loading favicons, and other tasks that are time-consuming, persistent, or resource-demanding.

See a guide on Configuring Windows Task Scheduler.