Install Locally

Install Locally

In this tutorial we will outline the steps to install Curity locally on Linux or macOS.

Download and Install

Download the latest release from the Curity Developer Portal.

The installation procedure is the same on both macOS and Linux, but with a pre-requisite on macOS.

MacOS pre-requisite

Make sure that OpenSSL is installed. We recommend using homebrew to install using the following command:
brew install openssl

After downloading the package, untar the server in a good location.

cd /opt
cp ~idsvr-5.3.1-linux-release.tar.gz .
tar xvf idsvr-5.3.1-linux-release.tar.gz

This creates a folder with the installation in the form idsvr-VERSION. Cd into that directory to run the installer.

cd idsvr-5.3.1

Now you will be prompted with a few options:

1. Accept the license agreement

To proceed, enter the number corresponding to your choice:

1. Accept
2. Decline
3. View agreement

The license agreement can be found in idsvr-VERSION/legal.

2. Optionally add license

If you already have a license you can paste it here, but it's also possible to add it later in the UI.

If you have a license, paste the entire JSON contents of the license file here
or type the path of the key file if it is on this machine. Press enter if you
do not have a license or wish to install it later by other means.

3. Set admin password

Creating initial admin user
Admin Enter your password:

4. Optionally encrypt sensitive configuration

Would you like to protect sensitive parts of the configuration with a unique encryption key? [y/N]

This is recommended for production systems, but is not needed for development.

5. Optionally enable Admin UI

Would you like to enable the Admin Web UI for the Curity Identity Server? [y/N]

Answer y

Start the first time

Start the server by running the following from the installation directory.


The output in the console will show that the server is starting and we can now turn to the browser to access the admin UI.

Open a browser and go to https://HOSTNAME:6749/admin where HOSTNAME is the host Curity is installed on. The first time you will be prompted to trust the certificate, since the installation creates one. This can be replaced later. Enter admin as username and enter the password you created during installation.

Next Steps

Now the Curity Identity Server is up and running but without any configuration. The next step is to set up the basic profiles and services. Move on to the First Configuration Tutorial.