nadeko/README.md

58 lines
3.1 KiB
Markdown
Raw Normal View History

2016-05-06 08:19:30 +00:00
# NadekoBot a Discord bot
Nadeko is written in C# and Discord.net for more information visit https://github.com/Kwoth/NadekoBot
2016-06-29 14:14:32 +00:00
## Install Docker
Follow the respective guide for your operating system found here https://docs.docker.com/engine/installation/
2016-05-06 08:19:30 +00:00
2016-06-29 14:14:32 +00:00
## Nadeko Setup Guide
For this guide we will be using the folder /nadeko as our config root folder.
2016-05-06 08:19:30 +00:00
```
2016-06-29 14:14:32 +00:00
docker run --name nadeko -v /nadeko:/config uirel/nadeko
2016-05-06 08:19:30 +00:00
```
2016-06-29 14:14:32 +00:00
Lots of text will scroll past as the container is setup. After a few minutes it will start looping with an error about a lack of a token.
Press CTRL+C at this point.
##UnRAID Installation
Installing Nadeko into a Docker container on an UnRAID server is a relatively simple process that can be done quickly and easily.
This guide assumes you already have Docker installed and working correctly on your server.
- First, create a new container using the button in the Docker tab of the UnRAID control panel.
- Next, put the UI into Advanced Mode using the toggle at the top right of the module below the banner.
- Enter the name of the container into the container name box. This can be whatever you want, it is just a label.
- For the repository box, type in `uirel/nadeko`.
- Set the network type to Host and check both the Privileged and Bind Time boxes
- To set config folder paths, enter `/config` into the Container Volume box and the path for the host location.
For example, `mnt/user/appdata/nadeko` is the location the container will save data to on disk.
- Leave the Environment Variables and Extra Parameters boxes blank unless you know what you are doing.
- For the Docker Hub URL, enter `https://github.com/Poag/nadeko`. This is how Docker finds the repository.
- Leave the WebUI and Banner boxes empty, and if you want to have an icon for the container in the UnRAID UI, put the URL in the box.
If everything was done correctly, hit the Create button at the bottom of the page and wait. The server should show a dialogue box that shows the image and its dependencies being pulled and extracted. Do not close this window until it is finished and you see the Done button at the bottom. After the installation is complete, you will see an error about a missing token begin to loop like you would with a regular terminal install. Go back to the Docker control panel and stop the container.
Once Nadeko is installed, you will have to edit your /nadeko/credentials.json file per the guide @ https://github.com/Kwoth/NadekoBot/wiki/Credentials.json-and-data-config.json using a tool of your choice eg nano
2016-06-29 14:27:20 +00:00
```
2016-06-29 14:14:32 +00:00
nano /nadeko/credentials.json
2016-06-29 14:27:20 +00:00
```
For UnRAID, navigate to your host path and you will find the `credentials.json` file inside.
2016-06-29 14:14:32 +00:00
Atfer editing the config file we can restart Nadeko
2016-05-06 08:19:30 +00:00
2016-05-09 07:50:26 +00:00
```
docker start nadeko
```
2016-06-29 14:14:32 +00:00
After a few moments you should be able to invite Nadeko to your server. If you cannot check the log file for errors
2016-06-29 14:14:50 +00:00
```docker logs nadeko```
2016-06-29 14:14:32 +00:00
2016-05-06 08:19:30 +00:00
## Updates / Monitoring
2016-05-06 08:35:56 +00:00
* Upgrade to the latest version of Nadeko simply `docker restart nadeko`.
2016-05-06 08:19:30 +00:00
* Monitor the logs of the container in realtime `docker logs -f nadeko`.
2016-05-06 08:20:57 +00:00
For information about configuring your bot or its functionality, please check the https://github.com/Kwoth/NadekoBot guides.