Docker Compose

Quick start guide for Deploying Asserts on Virtual or Physical Machine

Join Our Slack

Prerequisites

• At least 4 GB of RAM dedicated to the host running the Docker engine

  • 8Gb is recommended

• Docker Engine

• Docker-Compose >= v1.27.1

Install Docker Dependencies

Linux

Install Docker

1. Update the installed packages and package cache on your instance

   sudo yum update -y

2. Install the most recent Docker Engine package

   sudo yum install docker

3. Start the Docker service

   sudo service docker start

4. Verify that you can execute can execute Docker CLI commands

   docker -v
   # Docker version 20.10.11, build dea9396

Install Docker-Compose

1. Run this command to download the current stable release of Docker Compose:

   sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

2. Apply executable permissions to the binary:

   sudo chmod +x /usr/local/bin/docker-compose

3. Add to Path

   export PATH=$PATH:/usr/local/bin

4. Verify that you can execute docker-compose CLI commands

   docker-compose --version
   # docker-compose version 1.29.2, build 5becea4c

   For more info see 👉 Install Docker Compose

Mac

Install Docker Desktop

Docker Desktop for Mac includes both Docker & Docker-Compose in a single installation package.

For installation instructions: Install Docker Desktop on Mac

Windows

Install Docker Desktop

Docker Desktop for Windows includes both Docker & Docker-Compose in a single installation package.

For installation instructions: Install Docker Desktop on Windows

Optional Prerequisites

All Asserts services publish their own metrics, which are in turn consumed by Asserts so it can monitor itself. This enables you to install and run Asserts without the following prerequisites to get a taste of the value that Asserts aims to provide. However, to realize the full potential that Asserts can provide please consider satisfying the following prerequisites.

• A Prometheus compatible endpoint to query (can be multiple)

• node-exporter

• cadvisor

Install

1. Download the latest Asserts docker-compose files:

   • Docker-Compose.yml

   • .env

   • README

2. Pull Latest Images

   docker-compose pull

3. Run Asserts Services

   docker-compose up -d --remove-orphans

4. Open Asserts

   • Show All Services

   or run

   open http://localhost

5. Request a trial license to start observing!

Upgrade

1. Download the latest docker files:

   • Docker-Compose.yml

   • .env

2. Pull Latest Images

   docker-compose pull

3. Run Asserts Services

   docker-compose up -d --remove-orphans

Uninstall

1. Stop Asserts To Stop and Remove containers:

   docker-compose down

2. Managing Volumes Docker data volume persists even after a container is deleted. See how to manage persistent data here

Need Help