Passwordstate Documentation

Passwordstate Installation ​

Instructions for the initial installation of Passwordstate, and System Requirements.

System Requirements ​

Passwordstate has the following system requirements:

Web Server ​

Your web server which will host the Passwordstate website can be any of the following Operating System versions, with required components:

  • Microsoft Windows Server 2016, 2019, 2022 or Windows 11
  • Internet Information Services (installed as part of Passwordstate installation)
  • Microsoft SQL Server 2012 Native Client (installed as part of Passwordstate installation)
  • .NET Framework 4.7.2. or Higher (comes preinstalled with OS)
  • PowerShell 5.0 or above (comes preinstalled with OS)

Note: It is not recommended or supported to install Passwordstate on a Domain Controller WSUS Server, or SharePoint Server.

Database Server ​

You will need to have one of the following supported SQL Server versions installed prior to installing Passwordstate. SQL Server can be installed either on the same server as Passwordstate, or on any other Windows Server in your environment. Any versions of SQL Server can be used i.e. Express, Standard, Enterprise.

  • Microsoft SQL Server 2016
  • Microsoft SQL Server 2017
  • Microsoft SQL Server 2019
  • Microsoft SQL Server 2022 Alternatively, Passwordstate supports Azure SQL or Amazon RDS for SQL Server databases.

Important: SQL Server must be configured for mixed-mode authentication, so the Passwordstate website can connect to SQL Server using a local SQL Account. Active Directory Accounts cannot be used to connect to the database.

If you are unsure of how to install SQL Server, the Passwordstate.zip file contains some instructions for installing SQL Server Express edition.

Email Server ​

If you would like to receive emails generated from Passwordstate, you must also have an email server which is capable of sending anonymous SMTP emails, or emails from an authenticated mailbox.

Passwordstate also supports Microsoft Exchange online to send out emails, if you are licensed for that in Azure.

What Information is required for the Initial Setup ​

Prior to installing Passwordstate and running through the initial Setup Wizard, you will require the following information:

Let Passwordstate Create its Own Database ​

  • A local SQL Account (not an Active Directory account) with sufficient permissions to create the database – at a minimum the ‘dbcreator’ and ‘securityadmin’ SQL Server roles are required (The ‘sa’ account has these privileges, although some DBA’s do not like to use this account due to its elevated privileges. Please note these account credentials are never used again, and not stored anywhere post installation of Passwordstate).

During the initial setup, the following will occur:

  • a. The Passwordstate database will be created and populated with some base data
  • b. A SQL Account called ‘passwordstate_user’ will be created, and will be given db_owner rights to the Passwordstate database only

Create Your Own Database, and Let Passwordstate Connect to it ​

  • You will need to have created the empty database, and an SQL Account for Passwordstate to connect to this empty database. The SQL Account requires db_owner rights to the Passwordstate database only. It’s recommended to call this database “passwordstate” and the SQL account should be called “passwordstate_user” to ensure easier troubleshooting at a later date, if required.

Additional Setup Information ​

these options below can be configured after you have installed Passwordstate, or during the initial set up wizard

  • Your Registration Key details for Passwordstate
  • Host Name and Port Number of an email server capable of sending anonymous SMTP mail, or from an authenticated mailbox
  • SMTP Address from which Passwordstate will send the emails from
  • Proxy Server Details – Passwordstate can periodically check for the updates, and if your organization requires all internet access to go through a proxy server, you will need to specify the proxy host name and port number during the installation (this feature can also be disabled once you’re using Passwordstate if required).