Changes to docker guide
- Added copy command - Formatted in a way that is more similar to the other guides. - Better logical flow - Grammar fixes
This commit is contained in:
parent
85fcf0bc60
commit
3d8ee6ad32
@ -1,33 +1,43 @@
|
|||||||
# NadekoBot a Discord bot
|
# Setting up NadekoBot on Docker
|
||||||
Nadeko is written in C# and Discord.Net for more information visit <https://github.com/Kwoth/NadekoBot>
|
Nadeko is written in C# and Discord.Net for more information visit <https://github.com/Kwoth/NadekoBot>
|
||||||
|
|
||||||
## Install Docker
|
#### Prerequisites
|
||||||
Follow the respective guide for your operating system found here [Docker Engine Install Guide](https://docs.docker.com/engine/installation/)
|
- [Docker](https://docs.docker.com/engine/installation/)
|
||||||
|
- [Create Discord Bot application](http://nadekobot.readthedocs.io/en/latest/JSON%20Explanations/#creating-discord-bot-application) and [Invite the bot to your server](http://nadekobot.readthedocs.io/en/latest/JSON%20Explanations/#inviting-your-bot-to-your-server).
|
||||||
|
|
||||||
## Nadeko Setup Guide
|
#### Setting up the container
|
||||||
For this guide we will be using the folder /nadeko as our config root folder.
|
For this guide we will be using the folder /nadeko as our config root folder.
|
||||||
|
```
|
||||||
```bash
|
|
||||||
docker create --name=nadeko -v /nadeko/conf/:/root/nadeko -v /nadeko/data:/opt/NadekoBot/src/NadekoBot/bin/Release/netcoreapp1.1/data uirel/nadeko:1.4
|
docker create --name=nadeko -v /nadeko/conf/:/root/nadeko -v /nadeko/data:/opt/NadekoBot/src/NadekoBot/bin/Release/netcoreapp1.1/data uirel/nadeko:1.4
|
||||||
```
|
```
|
||||||
|
|
||||||
|
#### Moving `credentials.json` into the docker container.
|
||||||
|
|
||||||
- If you are coming from a previous version of nadeko (the old docker) make sure your credentials.json has been copied into this directory and is the only thing in this folder.
|
- If you are coming from a previous version of nadeko (the old docker) make sure your credentials.json has been copied into this directory and is the only thing in this folder.
|
||||||
|
- If you are making a fresh install, create your credentials.json from the following guide and place it in the /nadeko folder [Nadeko JSON Guide](http://nadekobot.readthedocs.io/en/latest/JSON%20Explanations/).
|
||||||
|
- To copy the the file from your computer to a container:
|
||||||
|
```
|
||||||
|
docker cp /Directory/That/Contains/Your/credentials.json nadeko:/credentials.json
|
||||||
|
```
|
||||||
|
|
||||||
-If you are making a fresh install, create your credentials.json from the following guide and place it in the /nadeko folder [Nadeko JSON Guide](http://nadekobot.readthedocs.io/en/latest/JSON%20Explanations/)
|
#### Start up docker
|
||||||
|
```
|
||||||
|
docker start nadeko; docker logs -f nadeko
|
||||||
|
```
|
||||||
|
The docker will start and the log file will start scrolling past. This may take a long time. The bot start can take up to 5 minutes on a small DigitalOcean droplet.
|
||||||
|
Once the log ends with "NadekoBot | Starting NadekoBot vX.X" the bot is ready and can be invited to your server. Ctrl+C at this point if you would like to stop viewing the logs.
|
||||||
|
|
||||||
Next start the docker up with `docker start nadeko; docker logs -f nadeko`
|
After a few moments, Nadeko should come online on your server. If it doesn't, check the log file for errors.
|
||||||
|
|
||||||
The docker will start and the log file will start scrolling past. Depending on hardware the bot start can take up to 5 minutes on a small DigitalOcean droplet.
|
#### Monitoring
|
||||||
Once the log ends with "NadekoBot | Starting NadekoBot v1.0-rc2" the bot is ready and can be invited to your server. Ctrl+C at this point to stop viewing the logs.
|
**To monitor the logs of the container in realtime**
|
||||||
|
```
|
||||||
|
docker logs -f nadeko
|
||||||
|
```
|
||||||
|
|
||||||
After a few moments you should be able to invite Nadeko to your server. If you cannot, check the log file for errors.
|
### Updates
|
||||||
|
|
||||||
## Monitoring
|
#### Manual
|
||||||
|
|
||||||
* Monitor the logs of the container in realtime `docker logs -f nadeko`.
|
|
||||||
|
|
||||||
## Updates
|
|
||||||
|
|
||||||
# Manual
|
|
||||||
Updates are handled by pulling the new layer of the Docker Container which contains a pre compiled update to Nadeko.
|
Updates are handled by pulling the new layer of the Docker Container which contains a pre compiled update to Nadeko.
|
||||||
The following commands are required for the default options
|
The following commands are required for the default options
|
||||||
|
|
||||||
@ -42,17 +52,17 @@ docker create --name=nadeko -v /nadeko/conf/:/root/nadeko -v /nadeko/data:/opt/N
|
|||||||
`docker start nadeko`
|
`docker start nadeko`
|
||||||
|
|
||||||
|
|
||||||
# Automatic Updates
|
#### Automatic
|
||||||
Automatic update are now handled by WatchTower [WatchTower GitHub](https://github.com/CenturyLinkLabs/watchtower)
|
Automatic update are handled by [WatchTower](https://github.com/CenturyLinkLabs/watchtower).
|
||||||
To setup WatchTower to keep Nadeko up-to-date for you with the default settings, use the following command
|
To setup WatchTower to keep Nadeko up-to-date for you with the default settings, use the following command:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
docker run -d --name watchtower -v /var/run/docker.sock:/var/run/docker.sock centurylink/watchtower --cleanup nadeko
|
docker run -d --name watchtower -v /var/run/docker.sock:/var/run/docker.sock centurylink/watchtower --cleanup nadeko --interval 300
|
||||||
```
|
```
|
||||||
|
|
||||||
This will check for updates to the docker every 5 minutes and update immediately. Alternatively using the `--interval X` command to change the interval, where X is the amount of time in seconds to wait. e.g 21600 for 6 hours.
|
This will check for updates to the docker every 5 minutes and update immediately. To check in different intervals, change `X`. X is the amount of time, in seconds. (e.g 21600 for 6 hours)
|
||||||
|
|
||||||
|
|
||||||
|
### Additional Info
|
||||||
If you have any issues with the docker setup, please ask in #help channel on our [Discord server](https://discordapp.com/invite/nadekobot) but indicate you are using the docker.
|
If you have any issues with the docker setup, please ask in #help channel on our [Discord server](https://discordapp.com/invite/nadekobot) but indicate you are using the docker.
|
||||||
|
|
||||||
For information about configuring your bot or its functionality, please check the [documentation](http://nadekobot.readthedocs.io/en/latest).
|
For information about configuring your bot or its functionality, please check the [documentation](http://nadekobot.readthedocs.io/en/latest).
|
||||||
|
Loading…
Reference in New Issue
Block a user