This documentation is for Stoplight customers that are on a self-hosted plan. Please contact firstname.lastname@example.org with any questions.
Before continuing, you'll need the following:
- Administrative access to a compatible Linux system (for technical and sizing guidelines, see here)
- A valid Stoplight license file, provided by email@example.com
- An email provider configuration in order to enable email notifications (see Email Requirements)
- Optionally, SSL certificates for configuring SSL (see SSL Requirements)
Email is currently required to be setup during the Stoplight installation process. To complete this portion, you'll need:
- The hostname and port for your mail server, and whether or not SSL is required
- The mail server username and password, if needed
If SSL will be enabled for your installation, you will also need:
- SSL certificate in the PEM format (.crt)
- SSL secret key in the PEM format (.key)
In an offline environment?
If you are running in an offline or air-gapped environment, use the instructions here for the initial setup process.
Stoplight leverages a tool called kURL in combination with KOTS in order to streamline the installation and deployment process of Stoplight on-premise. The kURL software is used for the creation of the embedded Kubernetes cluster, and KOTS is used within Kubernetes for the management of the Stoplight service and licensing.
If you have any questions or concerns regarding the use of this software, don't hesitate to reach out to firstname.lastname@example.org.
To start the installation, run the following command on the installation system:
curl -sSL https://k8s.kurl.sh/stoplight-platform | sudo bash
As part of the installation process, you will be prompted to create a password which will be used for the administration interface.
Be sure to record this password! It will be needed later in order to register the Stoplight license and access the administration console.
Once the setup is completed, you should be able to access the administrative interface on port 8800, prompting you for the previous administrator password:
Once authenticated, you will be able to upload your license file to register the license:
With the license in place, the Stoplight installation process will begin:
If you are not in an airgapped or offline environment, use the download Stoplight from the Internet button towards the bottom of the screen. Otherwise follow the instructions on the screen.
Once completed, there will be a quick test to ensure your environment meets the necessary requirements based on your license information (user counts, etc). Once completed, you should be greeted with the administrative interface:
Once completed, access the Stoplight ingress URL to use Stoplight and authenticate using the credentials provided by the configuration wizard.