Automated installation with Docker
Install FrontLine and Cassandra easily with Docker or Docker Compose
Running FrontLine with Docker is the recommended solution, as it requires the minimal amount of setup and is the easiest way to upgrade to newer versions.
Getting FrontLine’s Docker image
FrontLine’s image is hosted as a private image on Docker Hub.
Please contact our support and provide us with your Docker Hub username so we can grant you access.
The following command will start a single-node Cassandra cluster, using the official Cassandra image. This will also mount a local directory on the host into the container, to persist its data across starts/stops of the Cassandra container.
docker run -d \ --name cassandra \ -v <local directory to store Cassandra data>:/var/lib/cassandra \ -p 9042:9042 \ cassandra:3.11.6
Copy FrontLine default configuration
To be able to persist FrontLine (required, as it stores the license information and key used for data encryption), create a directory and copy FrontLine’s default configuration to a file named
The following command will start FrontLine, mapping to its default port on the host. This will also mount two volumes:
- A volume with FrontLine’s configuration, prepared by the previous step.
- A volume to store uploaded private keys (required by features like Git cloning and by some cloud providers)
docker run -d \ --name frontline \ -p 10542:10542 \ -v <configuration directory from the previous step>:/opt/frontline/conf \ -v <local directory to store private keys>:/opt/frontline/keys \ gatlingcorp/frontline:1.13.4
For your convenience, here are some docker compose instructions to set up a quick test environment. This is enough to start FrontLine locally.
Based on cassandra image
cassandra:3.11.6, you’ll have to bind a local directory on the volume to store and keep your data. A healthcheck will be started on the container.
Wait until cassandra container healthcheck indicates that all is well. Set the version of FrontLine you want to deploy, bind a local directory for FrontLine configuration and keys.
Create a folder to store the files, add the given
docker-compose.yml, then run
docker-compose up -d.
Once ready, visit FrontLine at http://localhost:10542!
version: '2.4' services: cassandra: container_name: cassandra image: cassandra:3.11.6 environment: - CASSANDRA_CLUSTER_NAME=FrontLine volumes: - cassandra:/var/lib/cassandra # - <path to your cassandra directory (default empty)>:/var/lib/cassandra networks: - frontline-network healthcheck: test: ["CMD-SHELL", "[ $$(nodetool statusgossip) = running ]"] interval: 30s timeout: 10s retries: 10 frontline: container_name: frontline image: gatlingcorp/frontline:1.13.4 ports: - 10542:10542 networks: - frontline-network environment: # FRONTLINE_CASSANDRA_HOST and FRONTLINE_CASSANDRA_PORT are used to update frontline.conf - FRONTLINE_CASSANDRA_HOST=cassandra volumes: - frontline-conf:/opt/frontline/conf - frontline-keys:/opt/frontline/keys # - <path to your frontline conf directory (default contains frontline.conf)>:/opt/frontline/conf # - <path to your frontline keys directory (default empty)>:/opt/frontline/keys depends_on: cassandra: condition: service_healthy volumes: cassandra: frontline-conf: frontline-keys: networks: frontline-network: driver: bridge