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
./installer.sh
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.
./idsvr/bin/idsvr
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.
Let’s Stay in Touch!
Get the latest on identity management, API Security and authentication straight to your inbox.