Download and Install
If you haven't downloaded Curity already you can find the latest release here
The installation procedure is the same on both macOS and Linux, but with a pre-requisite on macOS. See the macOS section in the end for details.
After you've downloaded the package, untar the server in a good location.
cd /opt cp ~idsvr-3.1.0-linux-release.tar.gz . tar xvf idsvr-3.1.0-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-3.1.0 ./installer.sh
Now you will be prompted with a few options:
1. Accept the license agreement, which can be found in the installation
To proceed, enter the number corresponding to your choice: 1. Accept 2. Decline 3. View agreement
2. Optionally add license
If you already have a license you can past it here, but we'll go through how to add it 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. If you like to enable SSH in Curity
Would you like to enable SSH, so that the Curity Identity Server can be administered remotely via the command line? [y/N]
We recommend: yes
4. Set an admin password
Creating initial admin user Admin Password:
5. Add RSA public keys for SSH
Enter a DSA or RSA SSH public key or file name containing such a public key for admin or leave it blank to not enable SSH public key authentication for this user:
You can leave this blank and hit enter.
6. 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.
7. Enable Admin UI
Would you like to enable the Admin Web UI for the Curity Identity Server? [y/N]
Start the first time
The first time you start you want to add the license if you haven't already.
Start the server by running the following from the installation directory.
The console will show that it's starting. We can now turn to the browser to access the admin UI.
Open a browser and go to
HOSTNAME is the host Curity is installed on.
The first time you will be promted to trust the certificate, since the installation creates one. This can be replaced later.
admin as username and the password you created during installation.
1. Click General
Click General and scroll down to the bottom
2. Drag and drop the license file
Click "Update license" and either drag and drop the file, or upload one.
If you don't have a license, go to the developer portal and request a new license via the License page in the User menu.
3. Commit the changes
Click "Commit" in the config menu, and accept the changes
Now Curity is up and running with a license installed. The next guide will take you through the first steps in order to setup an OAuth and an Authentication server.
When installing on macOS all the steps apply, but you need to make sure that OpenSSL is installed. We recommend using homebrew to install it as follows:
brew install openssl