Installation & Setup Guide

1. Create a Discord BOT Application

Log in with your Discord account.
Click on the + New App button.
Fill in the App Name (i.e., your bot's name), add an optional Avatar and Description for your bot.
Click on the Create App button.
Click on Create a Bot User button and confirm that you want to add a bot to this app.

2. Invite your BOT to Discord

Copy your bot's Client ID from your Discord Applications page.

Paste your Client ID here and click on Invite button, to invite your BOT to the server

3. Getting a Cleverbot API Key

Select a API Pack as per your requirements. Click on Add to Cart / Sign up now.
Input your details as mentioned. After you complete the signup, you will receive an email to verify your account. After you verify login to your account using the email & password you had selected during signup.
After you are successfully logged in to your account, you will see your API Key in My Accounds section.
Keep this page open, or copy your API Key, as you are going to need this during the BOT installation.

4. Getting HiRez API devId & authKey

Fill up the Hi-Rez Developer Credentials Application Form with correct details.
Then submit it. After HiRez Studios have verified you, they will mail you with your HiRez DevId & AuthKey.
It generally takes few hours, so you can proceed with the installation, as you can add these to your credentials.json file anytime later. See Configuration FAQ on how to do that.

5. Getting a Tracker Network API Key

Login/Register your account (Click Login/Register at the top right corner).
After you've (registered and) logged in, click on Generate API key.
Fill up the given form with your name, email, website (you can also use https://bastion.js.org) and description. After that click on Generate API key.
Then you'll see your API Key under the Authentication section.
Someting like: 845835a1-5xr3-8642-0915-18104fa12c1f
Keep this page open, or copy your API Key, as you are going to need this during the BOT installation.

6. Getting a Google API Key

Create a new project, name it anything you like. Once the project is created, click on Enable APIs.
Now, enable Google Static Maps API and URL Shortener API.
On the left tab, click Credentials. Then click Create Credentials button. Now click on API Key. A window will popup with your Google API key.
Keep this page open, or copy your API Key, as you are going to need this during the BOT installation.

7. Getting Twitch API Client ID & Client Secret

You need to have Twitch API Client ID & Client Secret to be albe to use the twitch command.
Read this article on How to get Twitch API Client ID & Client Secret.
Keep this page open, or copy your Client ID & Client Secret somewhere safe, as you are going to need this during the BOT installation.
If you need any help please ask us in Bastion: Discord Server.

8. Getting The Movie Database API Key

You need to have The Movie Database API Key to be albe to use the movie and tvShow commands.
Read The Movie Database FAQ to know how to get their API Key.
Keep this page open, or copy your API Key somewhere safe, as you are going to need this during the BOT installation.
If you need any help please ask us in Bastion: Discord Server.

9. Installation

Want to host Bastion on a VPS?

If you want Bastion to server 24/7 without having to hosting it on your PC and want to keep it cheap, reliable and convenient as possible, you can install Bastion, using following guide, on a Digital Ocean Linux VPS using this link (using this link will be supporting Bastion and will give you $10 credit)

Select your Operating System for specific installation instructions.

10. Updating

Updating is needed when new patch/update versions are released. When you update none of your data is lost.

To know when new versions of Bastion BOT are released, keep an eye on the #announcement channel of the Bastion BOT Official Discord Server.

GNU/Linux or macOS:

In your terminal, type:
cd ~/Bastion
Assuming you have Bastion BOT installed in your HOME directory. If you have moved Bastion to somewhere else, you can cd to Bastion directory in that location.
Then type:
sudo ./update.sh
Wait for a while for the Bastion Updated to finish updating, it will tell you when it's update. Then you can run the bot, as usual, by typing:
sudo ./run.sh

Windows:

Open you Bastion directory (It's in your desktop, if you haven't moved it after installation).
Right-Click on the update.cmd file and Click Run as Administrator.
Wait for a while for the Bastion Updated to finish updating, it will tell you when it's update. Then you can run the bot, as usual, by opening the run.cmd file.

11. Upgrading

Upgrading is needed when new minor/major versions are released. When you upgrade all bot data is lost & you have to configure the bot again.

To know when new versions of Bastion BOT are released, keep an eye on the #announcement channel of the Bastion BOT Official Discord Server.

GNU/Linux or macOS:

In your terminal, type:
cd ~/Bastion
Assuming you have Bastion BOT installed in your HOME directory. If you have moved Bastion to somewhere else, you can cd to Bastion directory in that location.
Then type:
sudo ./upgrade.sh
Wait for a while for the Bastion Updated to finish updating, it will tell you when it's update. Then you can run the bot, as usual, by typing:
sudo ./run.sh

Windows:

Open you Bastion directory (It's in your desktop, if you haven't moved it after installation).
Right-Click on the upgrade.cmd file and Click Run as Administrator.
Wait for a while for the Bastion Updated to finish updating, it will tell you when it's update. Then you can run the bot, as usual, by opening the run.cmd file.