Linux and Windows installers
Install Signing Server as a service on Linux with systemd or on Windows, interactively or with a response file.
The installers register Signing Server as an operating system service and install the common archive with its own Java runtime. They connect to an existing database and do not install one.
Prerequisites
Section titled “Prerequisites”| Platform | Requirement |
|---|---|
| Linux | x86_64 with systemd. An existing unprivileged signing account that you prepared. |
| Windows | x86_64 with the Windows service manager. Installation by an administrator. |
The installer does not create operating system accounts. Prepare a private configuration directory outside the installation directory, owned by the service account, with mode 0700 on Linux. Place your advanced configuration, key stores and secret files there. All passwords are file references. See Installation for the protection rules.
Install
Section titled “Install”- Verify the SHA-256 of the installer file before you run it.
- Run the installer interactively, or provide a response file for a silent installation. The response file has the same fields as the forms.
- Enter the database engine, host, port, name and account details. The new configuration must be a new file name in the configuration directory.
- Use Test connection. It checks the runtime connection and never changes the schema.
- Complete the installation. Schema migrations run at the first start, before the service reports readiness.
If the database check fails, the installer offers to retry, abort or finish with the service stopped. In a response file set on_database_failure to abort, retry (with probe_attempts of 1–3) or finish_stopped. A service finished in the stopped state is disabled and is not a ready signing service.
Verify
Section titled “Verify”Check that the service is running, then request GET /health/ready and expect UP. See Installation for the verification steps.
Uninstall
Section titled “Uninstall”Uninstalling removes the application files and the registered service. It keeps your configuration, secrets, keys and database.
Limits
Section titled “Limits”The installer does not upgrade an existing installation and does not manage operating system accounts. Back up configuration, keys and the database before you replace an installation.