Install Resoto with Docker
Resoto consists of multiple components published as individual Docker images:
somecr.io/someengineering/resotocoremaintains the infrastructure graph.
somecr.io/someengineering/resotoworkercollects infrastructure data from the cloud provider APIs.
somecr.io/someengineering/resotometricsexports metrics in Prometheus format.
somecr.io/someengineering/resotoshellprovides the command-line interface used to interact with Resoto.
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.
Fetch the required files from the
$ 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.ymlnote
By default, the
resotoshellservice bind-mounts the
/home/resoto/downloadsin 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-downloadsto another directory, you can do so by editing the
Start the services defined in the
$ 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
In Docker Compose V2, the command is
docker compose(no hyphen) instead of
Launching the Web UI
Resoto UI listens on port
8900by 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.
If it is your first time starting Resoto UI, the setup wizard will appear and help you configure Resoto:
Launching the Command-Line Interface
resh command is used to interact with
Simply execute the following to access the Resoto Shell interface:
$ docker exec -it resotoshell resh