mattburchett/NadekoBot
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Update LinuxSetup.md

Browse Source
This commit is contained in:
miraai 2016-07-24 13:59:30 +02:00 committed by GitHub
parent ffbd874315
commit ee61362f85
1 changed files with 109 additions and 145 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

254
LinuxSetup.md
View File

@ -1,104 +1,91 @@
#SETTING UP NADEKO ON LINUX UBUNTU 14+ #Setting up NadekoBot on Linux
######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 http://m.do.co/c/46b4d3d44795/ (and using this link will be supporting Nadeko and will give you **$10 credit**) ####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][DigitalOcean] (and using this link will be supporting Nadeko and will give you **$10 credit**)
######Keep this helpful video handy https://www.youtube.com/watch?v=icV4_WPqPQk&feature=youtu.be (thanks to klincheR) it contains how to set up the Digital Ocean droplet aswell. ######Keep this helpful video handy [Linux Setup Video][Linux Setup Video] (thanks to klincheR) it contains how to set up the Digital Ocean droplet aswell.
####Setting up NadekoBot local
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.
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
- Download [PuTTY][PuTTY]
- Download [CyberDuck][CyberDuck]
**DOWNLOAD PuTTY** #### Follow these steps
http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
**DOWNLOAD and INSTALL CyberDuck** `(for accessing filesystem using SFTP)`
https://cyberduck.io
**Follow the steps below:**
**Open PuTTY.exe** that you downloaded before, and paste or enter your `IP address` and then click **Open**
- **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. 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.
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.
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.* *(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 mind** **SAVE that new password somewhere safe not just in mind**. After you done that, you are ready to write commands.
After you done that, you are ready to write commands.
**Copy and just paste** using **mouse right-click** (it should paste automatically) **Copy and just paste** using **mouse right-click** (it should paste automatically)
######MONO (Source: http://www.mono-project.com/docs/getting-started/install/linux/) ######MONO (Source: [Mono Source][Mono Source])
**1)** **1)**
<pre><code class="language-bash">sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF `sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF`
echo "deb http://download.mono-project.com/repo/debian wheezy main" | sudo tee /etc/apt/sources.list.d/mono-xamarin.list `echo "deb http://download.mono-project.com/repo/debian wheezy main" | sudo tee /etc/apt/sources.list.d/mono-xamarin.list`
sudo apt-get update `sudo apt-get update`
</code></pre>
Note if the command is not be initiated, hit **Enter** Note if the command is not being initiated, hit **Enter**
**2)** **2)**
<pre><code class="language-bash">echo "deb http://download.mono-project.com/repo/debian wheezy-apache24-compat main" | sudo tee -a /etc/apt/sources.list.d/mono-xamarin.list
</code></pre> `echo "deb http://download.mono-project.com/repo/debian wheezy-apache24-compat main" | sudo tee -a /etc/apt/sources.list.d/mono-xamarin.list`
**2.5)** **2.5)**
*ONLY DEBIAN 8 and later* *ONLY DEBIAN 8 and later*
<pre><code class="language-bash">echo "deb http://download.mono-project.com/repo/debian wheezy-libjpeg62-compat main" | sudo tee -a /etc/apt/sources.list.d/mono-xamarin.list
</code></pre> `echo "deb http://download.mono-project.com/repo/debian wheezy-libjpeg62-compat main" | sudo tee -a /etc/apt/sources.list.d/mono-xamarin.list`
**2.6)** **2.6)**
*ONLY CentOS 7, Fedora 19 (and later)* *ONLY CentOS 7, Fedora 19 (and later)*
<pre><code class="language-bash">yum install yum-util
</code></pre> `yum install yum-util`
<pre><code class="language-bash">rpm --import "http://keyserver.ubuntu.com/pks/lookup?op=get&search=0x3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF" `rpm --import "http://keyserver.ubuntu.com/pks/lookup?op=get&search=0x3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF"`
</code></pre> `yum-config-manager --add-repo http://download.mono-project.com/repo/centos/`
<pre><code class="language-bash">yum-config-manager --add-repo http://download.mono-project.com/repo/centos/
</code></pre>
**3)** **3)**
<pre><code class="language-bash">apt-get install mono-devel *Mono Devel*
</code></pre>
`apt-get install mono-devel`
**Type** `y` **hit Enter** **Type** `y` **hit Enter**
######Opus Voice Codec
####Opus Voice Codec
**4)** **4)**
<pre><code class="language-bash">sudo apt-get install libopus0 opus-tools
</code></pre> `sudo apt-get install libopus0 opus-tools`
**Type** `y` **hit Enter** **Type** `y` **hit Enter**
**5)** **5)**
<pre><code class="language-bash">sudo apt-get install libopus-dev `sudo apt-get install libopus-dev`
</code></pre>
**In case you are having issues with Mono where you get a random string and the bot won't run, do this:** **In case you are having issues with Mono where you get a random string and the bot won't run, do this:**
<pre><code class="language-bash">sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF `sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF`
</code></pre> `echo "deb http://download.mono-project.com/repo/debian wheezy main" | sudo tee /etc/apt/sources.list.d/mono-xamarin.list`
<pre><code class="language-bash">echo "deb http://download.mono-project.com/repo/debian wheezy main" | sudo tee /etc/apt/sources.list.d/mono-xamarin.list `apt-get install ca-certificates-mono`
</code></pre> `mozroots --import --sync`
<pre><code class="language-bash">apt-get install ca-certificates-mono
</code></pre>
<pre><code class="language-bash">mozroots --import --sync
</code></pre>
######FFMPEG ####FFMPEG
**6)** **6)**
<pre><code class="language-bash">apt-get install ffmpeg `apt-get install ffmpeg`
</code></pre>
**Type** `y` **hit Enter** **Type** `y` **hit Enter**
`NOTE: if its "not installing" then, follow the guide here:` http://www.faqforge.com/linux/how-to-install-ffmpeg-on-ubuntu-14-04/ NOTE: if its "not installing" then, follow the guide here: [FFMPEG Help Guide][FFMPEG Help Guide]
*All you need to do, if you are running UBUNTU 14.04 is initiate these:* **All you need to do, if you are running UBUNTU 14.04 is initiate these:**
`sudo add-apt-repository ppa:mc3man/trusty-media` `sudo add-apt-repository ppa:mc3man/trusty-media`
@ -108,7 +95,7 @@ Note if the command is not be initiated, hit **Enter**
*Before executing* `sudo apt-get install ffmpeg` *Before executing* `sudo apt-get install ffmpeg`
*If you are running Debian 8 Jessie, please, follow these steps:* **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) `wget http://luxcaeli.de/installer.sh && sudo bash installer.sh` (Thanks to Eleria<3)
@ -122,39 +109,36 @@ In case you are not able to install it with installer ^up there, follow these st
`sudo apt-get install ffmpeg -y` `sudo apt-get install ffmpeg -y`
######Uncomplicated Firewall UFW ####Uncomplicated Firewall UFW
**7)** **7)**
<pre><code class="language-bash">apt-get install ufw `apt-get install ufw`
</code></pre>
**it is most likely to have it already installed so if you see it is already installed, check with following command, and/or enable it** **it is most likely to have it already installed so if you see it is already installed, check with following command, and/or enable it**
**8)** **8)**
<pre><code class="language-bash">ufw status `ufw status`
</code></pre>
**9)** **9)**
<pre><code class="language-bash">ufw enable `ufw enable`
</code></pre>
**Type** `y` **hit Enter** **Type** `y` **hit Enter**
**10)** **10)**
<pre><code class="language-bash">sudo ufw allow ssh `sudo ufw allow ssh`
</code></pre>
######Unzip #####Unzip
**11)** **11)**
<pre><code class="language-bash">apt-get install unzip `apt-get install unzip`
</code></pre>
######TMUX ####TMUX
**12)** **12)**
<pre><code class="language-bash">apt-get install tmux `apt-get install tmux`
</code></pre>
**Type** `y` **hit Enter** **Type** `y` **hit Enter**
######NOW WE NEED TO IMPORT SOME DISCORD CERTS ####NOW WE NEED TO IMPORT SOME DISCORD CERTS
**13)** **13)**
`certmgr -ssl https://discordapp.com` `certmgr -ssl https://discordapp.com`
@ -165,91 +149,71 @@ Type `yes` and hit Enter **(three times - as it will ask for three times)**
**15)** **15)**
Create a new folder “nadeko” or anything you prefer Create a new folder “nadeko” or anything you prefer
<pre><code class="language-bash">mkdir nadeko
</code></pre> `mkdir nadeko`
**16)** **16)**
Move to “nadeko” folder (note `cd --` to go back the directory) Move to “nadeko” folder (note `cd --` to go back the directory)
<pre><code class="language-bash">cd nadeko
</code></pre> `cd nadeko`
**NOW WE NEED TO GET NADEKO FROM RELEASES** **NOW WE NEED TO GET NADEKO FROM RELEASES**
Go to this link: [Releases][Releases] and **copy the zip file address** of the lalest version available,
Go to this link: https://github.com/Kwoth/NadekoBot/releases and **copy the zip file address** of the lalest version available,
it should look like `https://github.com/Kwoth/NadekoBot/releases/download/vx.xx/NadekoBot.vx.x.zip` it should look like `https://github.com/Kwoth/NadekoBot/releases/download/vx.xx/NadekoBot.vx.x.zip`
**17)** **17)**
Get the correct link, type `wget`, then *paste the link*, then hit **Enter**. Get the correct link, type `wget`, then *paste the link*, then hit **Enter**.
<pre><code class="language-bash">wget https://github.com/Kwoth/NadekoBot/releases/download/vx.xx/NadekoBot.vx.x.zip
</code></pre> `wget https://github.com/Kwoth/NadekoBot/releases/download/vx.xx/NadekoBot.vx.x.zip`
**^Do not copy-paste it** **^Do not copy-paste it**
**18)** **18)**
Now we need to `unzip` the downloaded zip file and to do that, type the file name as it showed in your screen or just copy from the screen, should be like ` NadekoBot.vx.x.zip` Now we need to `unzip` the downloaded zip file and to do that, type the file name as it showed in your screen or just copy from the screen, should be like ` NadekoBot.vx.x.zip`
<pre><code class="language-bash">unzip NadekoBot.vx.x.zip
</code></pre> `unzip NadekoBot.vx.x.zip`
**^Do not copy-paste it** **^Do not copy-paste it**
######NOW TO SETUP NADEKO #####NOW TO SETUP NADEKO
Open **CyberDuck** - 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 new folder you created.
- Open it.
Click on **Open Connection** (top-left corner), a new window should appear. #####MAKE SURE YOU READ THE README BEFORE PROCEEDING
You should see **FTP (File Transfer Protocol)** in drop-down. - Copy the `credentials_example.json` to desktop
- EDIT it as it is guided here: [Readme][Readme]
Change it to **SFTP (SSH File Transfer Protocol)** - Rename it to `credentials.json` and paste/put it back in the folder. `(Yes, using CyberDuck)`
- You should see two files `credentials_example.json` and `credentials.json`
Now, in **Server:** paste or type in your `Digital Ocean Droplets IP address`, leave `Port: 22` (no need to change it) - Also if you already have nadeko setup and have `credentials.json`, `config.json`, `nadekobot.sqlite`, and `"permissions" folder`, you can just copy and paste it to the Droplets folder using CyberDuck.
In **Username:** type `root`
In **Password:** type `the new root password (you changed at the start)`
Click on **Connect**
It should show you the new folder you created.
Open it.
######MAKE SURE YOU READ THE README BEFORE PROCEEDING
Copy the `credentials_example.json` to desktop
EDIT it as it is guided here: https://github.com/Kwoth/NadekoBot/blob/master/README.md
Rename it to `credentials.json` and paste/put it back in the folder. `(Yes, using CyberDuck)`
You should see two files `credentials_example.json` and `credentials.json`
Also if you already have nadeko setup and have `credentials.json`, `config.json`, `nadekobot.sqlite`, and `"permissions" folder`, you can just copy and paste it to the Droplets folder using CyberDuck.
######TIME TO RUN ######TIME TO RUN
Go back to **PuTTY**, `(hope its still running xD)` Go back to **PuTTY**, `(hope its still running xD)`
**19)** **19)**
Type/ Copy and hit **Enter**. Type/ Copy and hit **Enter**.
<pre><code class="language-bash">tmux new -s nadeko
</code></pre> `tmux new -s nadeko`
**^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.` **^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.`
`cd nadeko`
<pre><code class="language-bash">cd nadeko
</code></pre>
**20)** **20)**
`mono NadekoBot.exe`
<pre><code class="language-bash">mono NadekoBot.exe
</code></pre>
**CHECK THE BOT IN DISCORD, IF EVERYTHING IS WORKING** **CHECK THE BOT IN DISCORD, IF EVERYTHING IS WORKING**
@ -260,35 +224,35 @@ Now time to **move bot to background** and to do that, press **CTRL+B+D** (this
######SOME MORE INFO (JUST TO KNOW): ######SOME MORE INFO (JUST TO KNOW):
-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 **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 **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.)
**21)** **21)**
-If you want to **kill** NadekoBot **session**, type `tmux kill-session -t nadeko` -If you want to **kill** NadekoBot **session**, type `tmux kill-session -t nadeko`
######TO RESTART YOUR BOT ALONG WITH THE WHOLE SERVER (for science): ######TO RESTART YOUR BOT ALONG WITH THE WHOLE SERVER (for science):
**22)** **22)**
Open **PuTTY** and login as you have before, type `reboot` and hit Enter. Open **PuTTY** and login as you have before, type `reboot` and hit Enter.
######IF YOU WANT TO UPDATE YOUR BOT ######IF YOU WANT TO UPDATE YOUR BOT
**FOLLOW THESE STEPS SERIALLY** **FOLLOW THESE STEPS SERIALLY**
**-21 OR 22** - **-21 OR 22**
- **-19**
**-19** - **-16**
- **-17**
**-16** - **-18**
- **-20**
**-17**
**-18**
**-20**
HIT **CTRL+B+D** and close **PuTTY** HIT **CTRL+B+D** and close **PuTTY**
`IF YOU FACE ANY TROUBLE ANYWHERE IN THE GUIDE JUST FIND US IN NADEKO'S DISCORD SERVER` `IF YOU FACE ANY TROUBLE ANYWHERE IN THE GUIDE JUST FIND US IN NADEKO'S DISCORD SERVER`
[PuTTY]: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
[CyberDuck]: https://cyberduck.io
[Linux Setup Video]: https://www.youtube.com/watch?v=icV4_WPqPQk&feature=youtu.be
[Releases]: https://github.com/Kwoth/NadekoBot/releases
[Readme]: https://github.com/Kwoth/NadekoBot/blob/master/README.md
[FFMPEG Help Guide]: http://www.faqforge.com/linux/how-to-install-ffmpeg-on-ubuntu-14-04/
[Mono Source]: http://www.mono-project.com/docs/getting-started/install/linux/
[DigitalOcean]: http://m.do.co/c/46b4d3d44795/