Install Resoto

Docker images allow Resoto to be run in a loosely isolated environment called a container.

tip

Don't want to manage your own Resoto installation? Get started for free with Fix, an all-in-one security dashboard built on top of Resoto.

Prerequisites

• Docker

• Docker Compose >= 1.29

• At least 2 CPU cores and 8 GB of RAM

  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.

Directions

1. Fetch the required files from the someengineering/resoto GitHub repository:

   $ mkdir -p resoto/dockerV2
   $ cd resoto
   $ curl -Lo docker-compose.yaml https://github.com/someengineering/resoto/releases/download/3.9.0/docker-compose.yaml
   $ curl -Lo dockerV2/prometheus.yml https://raw.githubusercontent.com/someengineering/resoto/3.9.0/dockerV2/prometheus.yml
   note

   By default, the resotoshell service bind-mounts the ~/resoto-downloads directory to /home/resoto/downloads in the container. This allows you to access files outputted by Resoto Shell on the host.

   If you would like to change the download location from ~/resoto-downloads to another directory, you can do so by editing the docker-compose.yaml file:

   resotoshell:
     ...
     volumes:
       - ~/resoto-downloads:/home/resoto/downloads
     ...

2. Start the services defined in the docker-compose.yaml file:

   $ docker-compose pull
   $ 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 V2, the command is docker compose (no hyphen) instead of docker-compose.