Deploy Xill4 with Docker

Xill4's docker image is released on Cloudsmith.io, but is not publicly available. Therefore, logging in with your entitlement token is required in order to pull Xill4's docker image from the registry:

docker login docker.cloudsmith.io
Username: xillio/xill4
Password: YOUR-ENTITLEMENT-TOKEN

Login Succeeded

Note: You will need to replace YOUR-ENTITLEMENT-TOKEN with your own entitlement token. Also, as this is token-based authentication, it will only have read-only access, so you will be able to pull images but not push them.

To pull Xill4:

docker pull docker.cloudsmith.io/xillio/xill4/xill4:v4.x.x

Since Xill4 only exposes a single port, the deployment is relatively simple. Xill4 can be run with the following command:

docker run -d \
  --name=xill4 \
  -p 8000:8000 \
  -e XILL4_LICENSE_KEY=REPLACE-ME \
  -e XILL4_DATABASE_CONNECTION_STRING=REPLACE-ME \
  -e XILL4_ENVIRONMENT_SECRET=REPLACE-ME
  --restart unless-stopped \
  docker.cloudsmith.io/xillio/xill4/xill4:v4.x.x

In docker-compose format:

services:
  xill4:
    image: docker.cloudsmith.io/xillio/xill4/xill4:v4.x.x
    container_name: xill4
    environment:
        - XILL4_LICENSE_KEY=REPLACE-ME
        - XILL4_DATABASE_CONNECTION_STRING=mongodb://root:REPLACE-ME@mongo:27017/xill4_system?authSource=admin
        - XILL4_ENVIRONMENT_SECRET=REPLACE-ME
    ports:
      - 8000:8000
    restart: unless-stopped
  mongo:
    image: mongo:8
    environment:
      MONGO_INITDB_DATABASE: xill4_system
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: REPLACE-ME
    ports:
      - 27017:27017
    restart: unless-stopped

You can also configure Xill4 through a config.yml file which you can mount. For all settings configurable through environment variables or a config file see Updating Configurations.