We recommend this operating system and platform. Please ensure that your versions match these prior to install.
- Ubuntu 24.04 LTS
- 64bit Intel x86
Install the required pre-requisites Java8 and Postgres
sudo apt-get -y install openjdk-8-jre postgresql
Initialize the Postgres database:
sudo su -c "psql -c \"CREATE ROLE identity LOGIN PASSWORD 'identity' NOSUPERUSER INHERIT CREATEDB NOCREATEROLE NOREPLICATION;\"" postgres
sudo su -c "psql -c \"CREATE DATABASE identity WITH OWNER = identity ENCODING = 'UTF8' TEMPLATE = template0 TABLESPACE = pg_default CONNECTION LIMIT = -1;\"" postgres
sudo su -c "psql -c \"CREATE EXTENSION IF NOT EXISTS hstore;\" identity" postgres
Unzip the contents of the identity-server zip file to a folder on the machine.
We typically use: /opt/pi/identity-server
sudo mkdir -p /opt/pi/identity-server
sudo unzip identity-server-*.zip -d /opt/pi/identity-server
Go into the service bin directory and execute the installDaemon.sh command to install it as a service
cd /opt/pi/identity-server/service/bin
sudo chmod +x *.sh
sudo ./installDaemon.sh
After that you should be able to start the service via:
sudo systemctl start pi-identity-server
The service runs via https at port 8443. You should be able to access the web interface from a browser by going to:
https://<ip-address>:8443
The default credentials are
Username: admin
Password: password
Once you connect you should see a first run setup screen that takes you through configuring and licensing the server.
Use the provided the license key and activation token.
Congrats! You have installed an Identity Server on Linux!