Install OctoBot on your Computer
After installation, OctoBot starts in node mode and opens its node interface. From there you can:
- Run automations configured and monitored from the new OctoBot interface or the mobile app (recommended for most users).
- Launch manual OctoBots with their own interface, deeper configuration and the backtesting engine (for expert users).
See the getting started guide for setup steps, or the connect guide if you have connection issues.
Option 1: With the executable
- Download the latest version for your system using the latest release on GitHub. There is an OctoBot executable for:
- Start the downloaded executable. OctoBot opens a terminal, initializes its configuration environment and the OctoBot node interface opens automatically.
On Windows, you can just double click the executable.
On Linux, first typechmod +x OctoBot_linux_x64and then./OctoBot_linux_x64in a terminal open next to your downloaded executable to start OctoBot.
After install: Initialize your OctoBot and start your first automated strategy with a risk-free virtual account.
Option 2: With Docker
- If you don’t have Docker, install it on your system. Here is the docker documentation for Ubuntu, Debian and Raspberry pie.
- Download the OctoBot image using the command:
docker pull drakkarsoftware/octobot:stable - Start your OctoBot using the command:
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
The node interface is at http://localhost:8000/. Manual OctoBot instances use ports in the 5001-5010 range when you start them from the node.
Find all the details regarding the docker installation on our OctoBot with docker guide
After install: Initialize your OctoBot and start your first automated strategy with a risk-free virtual account.
Option 3: From the source code
Deploy your OctoBot from the code to be able to use a local Python environment, edit or audit the source code.
- If you don’t already have Python 3.10, install Python in version 3.10.
- Clone the OctoBot repository
git clone https://github.com/Drakkar-Software/OctoBot - Install the Python dependencies
cd OctoBot
python3 -m pip install -Ur requirements.txt - Start your OctoBot using this command:
python3 start.py
The node interface is at http://localhost:8000/ after python3 start.py.
Find all the details regarding the source code based installation on the python and git installation guide.
After install: Initialize your OctoBot and start your first automated strategy with a risk-free virtual account.
Initialize your OctoBot
After installation: Starting your OctoBot
- Open the node setupOpen
http://localhost:8000on the PC where OctoBot is running. The node setup screen opens in your browser. - Set up your node walletOn the node, create or import your node wallet to secure your node and its data. This wallet is not a cryptocurrency wallet, do not use a crypto wallet private key and never share your private key with anyone.
- Connect your Node to your OctoBot interfaceFrom the Connect your Node to your OctoBot interface step (or Settings → Connect → Web tab), open new.mobile.octobot.cloud. I already have a wallet → I already have a private key. Paste Copy your private key from this node. Then new automation → any type → Add a node → Existing install. Hostname: the hostname or IP the node shows. Port: 8000 (or what the node shows). Click Save when the checks turn green. Still Unreachable? Check our connection troubleshoot.
- Launch your first OctoBotOn new.mobile.octobot.cloud, leave demo mode on (default for risk-free simulated trading). Add an exchange account with 1000 USDC (or the crypto of your choice). Start a new automation (for example a Grid on BTC/USDC, if you added USDC to the demo account) and follow your automation from your OctoBot interface.
- Your node is now executing your strategyWhen you start an automation, the node runs it on its computer. You do not need to keep the browser tab or app open. Just leave the OctoBot program running so that it keeps trading. You can run as many automations as you want, on most crypto exchanges, with demo and real accounts. When needed, feel free to stop and restart your node, it will resume trading when you turn it back on.
Use new.mobile.octobot.cloud or the iOS or Android app on a regular basis to follow your investments and turn automations on and off. Go back to the node interface at http://localhost:8000 only for configuration, administration, or to connect to a new phone or computer.
Connection problems? Read the Node Connect Guide. If your node shows Unreachable, see connection common issues.
Other option: using a cloud
If you prefer using a server to run your OctoBot, here is the DigitalOcean cloud installation Guide.
Installing OctoBot on a server is a simple way to let your OctoBot execute its strategies 24/7.
