NadekoBot/docs/guides/Linux Guide.md
Jordan Fearnley fc15f95fcb Minor Guide Updates
- Less saving of `credentials.json` required
- Only needing to use `credentials_example.json` if you fuck up
accounted for
- Restore and build in one swift move accounted for
2016-10-22 09:05:42 +01:00

7.6 KiB

##Setting up NadekoBot on Linux

####Setting up NadekoBot on Linux Digital Ocean Droplet If you want Nadeko to play music for you 24/7 without having to hosting it on your PC and want to keep it cheap, reliable and convenient as possible, you can try Nadeko on Linux Digital Ocean Droplet using the link DigitalOcean (and using this link will be supporting Nadeko and will give you $10 credit)

####Setting up NadekoBot Assuming you have followed the link above to created an account in Digital Ocean and video to set up the bot until you get the IP address and root password (in email) to login, its time to begin.

Prerequisites

Follow these steps

  • Open PuTTY.exe that you downloaded before, and paste or enter your IP address and then click Open. If you entered your Droplets IP address correctly, it should show login as: in a newly opened window.
  • Now for login as:, type root and hit enter.
  • It should then, ask for password, type the root password you have received in your email address registered with Digital Ocean, then hit Enter.

(as you are running it for the first time, it will most likely to ask you to change your root password, for that, type the "password you received through email", hit Enter, enter a "new password", hit Enter and confirm that "new password" again. SAVE that new password somewhere safe, not just in your mind. After you've done that, you are ready to write commands.

Copy the messages as normal, and just paste by using mouse right-click (it should paste automatically)

####Installing git and dotnet 1) sudo apt-get install git -y

Note if the command is not being initiated, hit Enter

Go to this link provided by microsoft for instructions on how to get the most up to date version of the dotnet core sdk!
Make sure that you're on the correct page for your distribution of linux as the guides are different for the various distributions

We'll go over the steps here for Ubuntu 16.04 anyway (these will only work on Ubuntu 16.04), accurate as of 16/10/2016

2)

sudo sh -c 'echo "deb [arch=amd64] https://apt-mo.trafficmanager.net/repos/dotnet-release/ xenial main" > /etc/apt/sources.list.d/dotnetdev.list'

sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893

sudo apt-get update && sudo apt-get install dotnet-dev-1.0.0-preview2-003131 -y

####Installing Opus Voice Codec and libsodium 3) sudo apt-get install libopus0 opus-tools libopus-dev libsodium-dev -y

####FFMPEG 4) apt-get install ffmpeg -y

NOTE: if its "not installing" then, follow the guide here: FFMPEG Help Guide

If you are running UBUNTU 14.04, you must run these first:

sudo add-apt-repository ppa:mc3man/trusty-media
sudo apt-get update
sudo apt-get dist-upgrade

Before executing sudo apt-get install ffmpeg

If you are running Debian 8 Jessie, please, follow these steps:

wget http://luxcaeli.de/installer.sh && sudo bash installer.sh (Thanks to Eleria<3)

In case you are not able to install it with installer ^up there, follow these steps:

sudo apt-get update
echo "deb http://ftp.debian.org/debian jessie-backports main" | tee /etc/apt/sources.list.d/debian-backports.list
sudo apt-get update && sudo apt-get install ffmpeg -y`

####Uncomplicated Firewall UFW

5) apt-get install ufw

It is likely to have been pre-installed so if you see that it is installed, check it works with the following command, and/or enable it

6) ufw status

7) ufw enable

Type y ** and hit Enter**

8) sudo ufw allow ssh

####Installing TMUX 9) sudo apt-get install tmux -y

####Getting NadekoBot

10) cd ~ && git clone -b 1.0 --recursive https://github.com/Kwoth/NadekoBot.git

####Building NadekoBot

11) cd ~/NadekoBot/ && dotnet restore && cd ~/NadekoBot/src/NadekoBot/ && dotnet build --configuration Release

####Setting up NadekoBot

  • Open CyberDuck
  • Click on Open Connection (top-left corner), a new window should appear.
  • You should see FTP (File Transfer Protocol) in drop-down.
  • Change it to SFTP (SSH File Transfer Protocol)
  • Now, in Server: paste or type in your Digital Ocean Droplets IP address, leave Port: 22 (no need to change it)
  • In Username: type root
  • In Password: type the new root password (you changed at the start)
  • Click on Connect
  • It should show you the NadekoBot folder which was created by git earlier
  • Open that folder, then open the src folder, followed by another NadekoBot folder and you should see credentials.json here

####Setting up credentials.json

  • Copy the credentials.json to desktop
  • EDIT it as it is guided here: Setting up credentials.json
  • Read here how to create a DiscordBot application.
  • Paste/put it back in the folder once done. (Yes, using CyberDuck)
  • If you already have nadeko setup and have credentials.json and NadekoBot.db, you can just copy and paste the credentials.json to NadekoBot/src/NadekoBot and NadekoBot.db to NadekoBot/src/NadekoBot/bin/Release/netcoreapp1.0/data using CyberDuck.

####Running NadekoBot

Go back to PuTTY, (hope its still running xD)

12) Type/ Copy and hit Enter.

tmux new -s nadeko
cd NadekoBot/src/NadekoBot/
^this will create a new session named “nadeko” (you can replace “nadeko” with anything you prefer and remember its your session name) so you can run the bot in background without having to keep running PuTTY in the background.

13) dotnet run --configuration Release

CHECK THE BOT IN DISCORD, IF EVERYTHING IS WORKING

####Setting up Nadeko Music

For how to set up Nadeko for music and Google API Keys, follow Setting up NadekoBot for Music

Now time to move bot to background and to do that, press CTRL+B+D (this will detach the nadeko session using TMUX), and you can finally close PuTTY now.

Copy your CLIENT ID (In the same Developer page where you got your token!) and replace 12345678 in this link: https://discordapp.com/oauth2/authorize?client_id=12345678&scope=bot&permissions=66186303 with it. Go to that link and you will be able to add your bot to your server.

NOW YOU HAVE YOUR OWN NADEKO BOT Thanks to Kwoth <3

####Some more Info (just in case)

  • If you want to see the sessions after logging back again, type tmux ls, and that will give you the list of sessions running.
  • If you want to switch to/ see that session, type tmux a -t nadeko (nadeko is the name of the session we created before so, replace “nadeko” with the session name you created.)
  • If you want to kill NadekoBot session, type tmux kill-session -t nadeko

####Restarting Nadeko with the Server Open PuTTY and login as you have before, type reboot and hit Enter.

####Updating Nadeko

  • Make sure the bot is not running
  • Connect to the terminal
  • cd ~\NadekoBot\
  • git init && git pull
  • Run the bot again as normal, and you've updated!

HIT CTRL+B+D and close PuTTY

IF YOU FACE ANY TROUBLE ANYWHERE IN THE GUIDE JUST FIND US IN NADEKO'S DISCORD SERVER