Skip to main content
Version: 3.1.0

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.

Resoto consists of multiple components published as individual Docker images:

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

  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.1.0/docker-compose.yaml
    $ curl -Lo dockerV2/prometheus.yml https://raw.githubusercontent.com/someengineering/resoto/3.1.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 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.

Launching the Web UI

  1. Resoto UI listens on port 8900 by default. You can access it by opening https://localhost:8900 in your browser.

    note

    The SSL certificate is self-signed, but you can safely ignore any browser warnings.

  2. If it is your first time starting Resoto UI, the setup wizard will appear and help you configure Resoto:

    Screenshot of Resoto UI

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 resotoshell resh

Resoto Shell