Install on Docker

Ensure Docker is installed correctly
We won't help with issues relating to Docker installation/troubleshooting. Please ensure docker is installed correctly before installing Bastion on docker.
Commands are denoted by $. Lines without it are sample/expected output.
$ docker run hello-world
​
Hello from Docker
This message shows that your installation appears to be working correctly.
If get the output as per above you should be good to go. If you have to run docker as root, ensure your user is in the docker group. (usermod -aG docker $USER)
Prerequisites
This guide was written using Linux commands, and assumes you are using a Linux machine.
Docker runs on Linux, macOS and Windows so syntax should for the most part be interchangeable.
Ensure you have MongoDB installed either locally on a machine on your local network OR have MongoDB Atlas setup and ready. The base Bastion image Does Not include Mongo.
Make sure to keep your Atlas connection url, database user and password handy.
Bastion's Docker image has support for ENV's now so unless you need to run cron jobs or wish to have more than 2 prefixes or owners i would recommend sticking to using ENV's.
If you intend to run the image on a system that you don't own i recommend filling out an env file and passing in the ENV's through that. otherwise anyone who has access to the docker runtime can pull your bot token.
Preparation
Pull the Docker image:
$ docker pull joshj23/bastionbot
​
Using default tag: latest
latest: Pulling from joshj23/bastionbot
Digest: sha256:13db470f4a2de34fd76e27c14d307595754c87cd9c1ce41e7a346336df507a06
Status: Image is up to date for joshj23/bastionbot:latest
Digest hash will vary depending on the version, it's fine if yours doesn't match.
Running Bastion with configuration and credential files
If you wish to skip using ENV's you can still use config files akin to how it was done in V7.
You'll want to grab the credentials.example.yaml and configurations.example.yaml from Bastion's Github repository. rename them to credentials.yaml and configurations.yaml respectively. https://github.com/TheBastionBot/Bastion/tree/master/settings​
Configuring Bastion
At this stage, we are done, If you don't plan to use config files, head over to the Run on docker page, otherwise keep reading.
Head over to the Configure Bastion page and once configured, head over to the Run on Docker page

Install - Previous

Install on Windows

Next - Install

Install on DigitalOcean

Last modified 1yr ago

Copy link

Outline

Ensure Docker is installed correctly

Prerequisites

Preparation

Running Bastion with configuration and credential files