Skip to main content
Version: 2.4.1

Install Resoto with Docker

Docker provides the ability to run an application in a loosely isolated environment called a container. For more information on Docker, please see the official Docker documentation.

Prerequisites

note

Resoto performs CPU-intensive graph operations. In a production setup, we recommend at least four cores and 16 gigabytes of RAM. See Configuring Resoto Worker for more information.

Installing Resoto

Resoto consists of multiple components published as individual Docker images:

  1. somecr.io/someengineering/resotocore maintains the infrastructure graph.
  2. somecr.io/someengineering/resotoworker collects infrastructure data from the cloud provider APIs.
  3. somecr.io/someengineering/resotometrics exports metrics in Prometheus format.
  4. somecr.io/someengineering/resotoshell provides the command-line interface used to interact with Resoto.

To install Resoto using Docker Compose, first fetch the required files from the someengineering/resoto GitHub repository:

$ mkdir -p resoto/dockerV2
$ cd resoto
$ curl -o docker-compose.yaml https://raw.githubusercontent.com/someengineering/resoto/2.4.1/docker-compose.yaml
$ curl -o dockerV2/prometheus.yml https://raw.githubusercontent.com/someengineering/resoto/2.4.1/dockerV2/prometheus.yml
$ docker compose up -d

Upon execution of docker compose up -d, Docker Compose will start all components and set up the system. This process takes approximately 1-3 minutes, depending on your machine and internet connection.

note

Docker Compose V2 integrated compose functions in to the Docker platform.

In Docker Compose V1, the command is docker-compose (with a hyphen) instead of docker compose.

info

Resoto publishes packages for both x86 and ARM architectures for stable releases, but edge versions are only available for x86.

If you have an Apple Silicon or other ARM-based machine, please use the latest stable release (2.4.1 or latest).

Launching the Command-Line Interface

The resh command is used to interact with resotocore.

Simply execute the following to access the Resoto Shell interface:

$ docker exec -it resoto-resotoshell-server-1 resh

Resoto Shell