Clarity Gateway
Search…
⌃K

Runnning Clarity Gateway on a 3rd Party Device

Clarity Gateway runs on a wide range of devices that have a modern Linux OS and Docker runtime.

Installing Docker

To install the Docker runtime on your device, download the Docker installation convenience script:
curl -fsSL https://get.docker.com -o get-docker.sh
Execute the script:
sudo bash get-docker.sh
Running the Docker installation script
To run Docker commands on your device without typing sudo, run the following command:
sudo usermod -aG docker pi
After running the usermod command, you'll need to close your terminal and open a new terminal session before the changes take effect.

Running Clarity Gateway

To ensure that Clarity Gateway's configuration and data aren't lost every time you restart the connector, you'll need to map a data directory from the host OS to the Clarity Gateway container. Choose a location for the data directory and create the directory. In this example, we're using /data/clarity-gateway as our data directory:
sudo mkdir -p /data/clarity-gateway
To pull and run the Clarity Gateway container, type the following command:
docker run --name clarity-gateway -p 80:80 -v <DATA DIRECTORY>:/data --restart unless-stopped -d jcoreio/clarity-gateway:<VERSION>
If your data directory is /data/clarity-gateway and you want to run version 5.1.4, the command would be:
docker run --name clarity-gateway -p 80:80 -v /data/clarity-gateway:/data --restart unless-stopped -d jcoreio/clarity-gateway:5.1.4
Check the Clarity Gateway page on Docker Hub for a list of available versions.
Run the docker ps command to check that Clarity Gateway is running:

Accessing the Web Interface

Point your browser to http://<DEVICE IP ADDRESS> (for example, http://192.168.1.220) to access the Clarity Gateway web interface:
The default password is password.
Please secure your device by changing your password immediately after starting Clarity Gateway!
After you've successfully logged in, you will see the license entry screen. Enter your license key if you have one, or click "Start Trial" to try Clarity Gateway free for 2 hours:
After entering your license or starting the trial, you can get data flowing through Clarity Gateway by creating connectors:

Container logs

Run the docker logs clarity-gateway to see the container's logs:
In the example above, the container started successfully. You can safely ignore the error message about the local I/O driver: that driver only runs on the Iron Pi, and Clarity Gateway can operate without it.