Standard installation
Windows Server

Online installation

17min

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.

Preparing and receiving the archive

Open PowerShell as "Administrator":

When using Windows Server 2016, you must enable the TLS 1.2 security protocol using the command:

PowerShell


Get the PassworkModule.zip archive into the current directory:

PowerShell


In case of errors, the archive can be downloaded manually: https://repos.passwork.pro/repository/windows-powershell/PassworkModule.zip

Unzip the PowerShell module:

PowerShell


Installation

Start the online installation of Passwork:

PowerShell


Process of executing the installation script

The script will perform a user rights check and perform the download, installation and configuration of the components. If errors occur, the PowerShell shell will display the errors:

Document image


During execution, the script requests the certificate number from the customer portal:

Document image


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

Document image


Setup wizard

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

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:

Document image


System parameters check

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

Document image


Database connection

You must use the default MongoDB address to connect:

Document image


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.

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

Document image


License keys

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

Document image


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":

Document image


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

Document image


Use Let's Encrypt

If there is no domain CA (certificate issued by a trusted CA), but there is a public DNS name of the server, you can configure Let's Encrypt.

Passwork will be made available over HTTPS using a certificate from Let's Encrypt.

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 setting up background tasks.