Install OctoBot with Docker in video

For unix distribution only

Quick install

• In a terminal, enter the command to install the necessary packages:

sudo apt install git build-essential ca-certificates curl gnupg lsb-release -y

• Next, enter the command to install Docker:

curl -fsSL https://get.docker.com -o get-docker.sh
sh ./get-docker.sh

• Then download the OctoBot docker-compose file:

curl -fs https://raw.githubusercontent.com/Drakkar-Software/OctoBot/master/docker-compose.yml -o docker-compose.yml

• Start OctoBot with the previously downloaded docker-compose file:

docker compose up -d

• Don’t forget to run the following command at the end of the installation (and logout)

sudo usermod -aG docker $USER

After install: Initialize your OctoBot and start your first automated strategy with a risk-free virtual account.

Manual install

Using the stable image:

1. Download OctoBot

docker pull drakkarsoftware/octobot:stable

2. Start OctoBot (for linux x64/x86 and raspberry linux arm64/arm32)

docker run -itd --name OctoBot -p 8000:8000 -p 5001-5010:5001-5010 -v $(pwd)/user:/octobot/user -v $(pwd)/tentacles:/octobot/tentacles -v $(pwd)/logs:/octobot/logs drakkarsoftware/octobot:stable

After install: Initialize your OctoBot and start your first automated strategy with a risk-free virtual account.

Using the latest image (might be unstable):

1. Download OctoBot latest

docker pull drakkarsoftware/octobot:latest

2. Start OctoBot (for linux x64/x86 and raspberry linux arm64/arm32)

docker run -itd --name OctoBot -p 8000:8000 -p 5001-5010:5001-5010 -v $(pwd)/user:/octobot/user -v $(pwd)/tentacles:/octobot/tentacles -v $(pwd)/logs:/octobot/logs drakkarsoftware/octobot:latest

After install: Initialize your OctoBot and start your first automated strategy with a risk-free virtual account.

How to look at OctoBot logs ?

docker logs OctoBot -f

How to stop OctoBot ?

docker stop OctoBot

How to restart OctoBot ?

docker restart OctoBot

How to update OctoBot ?

docker pull drakkarsoftware/octobot:stable
docker stop OctoBot
docker rm OctoBot
docker run -itd --name OctoBot -p 8000:8000 -p 5001-5010:5001-5010 -v $(pwd)/user:/octobot/user -v $(pwd)/tentacles:/octobot/tentacles -v $(pwd)/logs:/octobot/logs drakkarsoftware/octobot:stable

Running with docker-compose

A simple way to run a docker image is to use docker-compose :

• Install docker-compose

• Download the docker-compose.yml file

• Create a .env file in the current folder

• Add HOST=YOUR_IP_ADDRESS in the newly created .env file. (where YOUR_IP_ADDRESS is the ip address of the computer, can be replaced by localhost if it’s a local computer)

• Start OctoBot with docker-compose (with the previous file docker-compose.yml in the current folder):

  docker-compose up -d

After docker compose up, open the node interface at http://localhost:8000/ on the host machine (or map NODE_PORT in .env if you changed it).

After install: Initialize your OctoBot and start your first automated strategy with a risk-free virtual account.

Start multiple nodes with docker

To run a second node on the same computer, use a new container name, a new user folder, and map a different host port to 8000 (for example -p 8001:8000). Each manual OctoBot started from a node uses ports from the 5001-5010 range inside that container.

Start OctoBot with docker managed files

Warning: It’s easier to use but it will not be possible to update it without deleting its files.

-v arguments can be removed from previous start commands but OctoBot’s local files will then be managed by docker (and not directly visible).

docker run -itd --name OctoBot -p 8000:8000 drakkarsoftware/octobot:stable

Local OctoBot files path are located in /var/lib/docker and can be listed with the following command

docker inspect -f '{{ .Mounts }}' OctoBot

To copy files of a directory outside the OctoBot container, for example for logs files :

docker cp OctoBot:/octobot/logs/. .

Wherer “OctoBot” is your container name

Initialize your OctoBot