Running your first OT on Ubuntu Linux #2
Conversation
|
@DSpeichert I've changed the points you've pointed out, thanks for letting me know. Happy to learn things the more professional way. Also added the final part which I totally forgot to setup TFS. |
| # Getting started | ||
| Rent a Ubuntu Server 18.04 or higher from a trusted hosting company such or install for the sake of learning experience Ubuntu Server 18.04 or higher in VirtualBox. | ||
|
|
||
| Once you're set we will start by accessing our server. If you're on windows you should get putty(https://www.putty.org/), if you're on macOS or Linux you can use the terminal which is standard available. With putty just follow the screen ( insert your domain/ip-address and click ok ) for macOS and linux users type: |
There was a problem hiding this comment.
I think it would be safer to recommend using Windows Subsystem for Linux as a native SSH client or simply installing SSH client via Windows features.
There was a problem hiding this comment.
Here you have a point indeed! WSL is safer, but putty would be easier for new people. It would be your call what you would like to be better in there.
| ```bash | ||
| sudo apt install nginx php-fpm mariadb-server -y | ||
| ``` | ||
| The installation process is now triggered.When this is finished we will install phpmyadmin to handle our database server (which is mariadb) |
There was a problem hiding this comment.
Missing space, capitalization (MariaDB)
There was a problem hiding this comment.
Removed the part as its not necessary to be there.
| ``` | ||
| The output will be looking something similar as this (I am using ubuntu 19.10 here which uses php version 7.3 as default. If you're running on a server you most likely run on 18.04 lts or with the newest version 20.04 lts): | ||
|
|
||
|  |
There was a problem hiding this comment.
what is this website? It should ideally be just text, let's avoid images of text.
|
|
||
|  | ||
|
|
||
| Second we want to do is enabling php in our nginx server and setting the configuration just as we want. So we will be going to edit our nginx config. Now we need to install a command line text editor called "vim". After that we installed it we will directly open the configuration file. |
There was a problem hiding this comment.
nano is easier than vim but it's just a matter of preference.
There was a problem hiding this comment.
I struggle with nano 🔢
There was a problem hiding this comment.
Unless you know your audience already knows vi, nano is the safe bet. The audience that already knows vi probably wouldn't need this portion of the guide in the first place.
Though, if you are aiming for the neophytes and you know they are using modern systems, such as Ubuntu 20.04LTS, micro should take precedence over nano.
| sudo apt install vim -y && sudo vim /etc/nginx/sites-available/default | ||
| ``` | ||
|
|
||
| Now sit straight up and read carefully on what we're going to do. I am going to give you a few options in the configuration. Underneath here you will find the default configuration file of nginx. ( I only took the part of the config file we are in need to use and left out all the comments which we do use in this tutorial ) |
There was a problem hiding this comment.
Now sit straight up and read carefully on what we're going to do.
While funny, this is meta-text and doesn't actually contribute anything. Let's avoid unnecessary prose.
| ```bash | ||
| sudo mariadb | ||
| ``` | ||
|  |
| `sudo vim /etc/nginx/sites-available/phpmyadmin` | ||
| ```bash | ||
| server { | ||
| listen 2344; |
There was a problem hiding this comment.
Just took a random port, can be changed to what you desire.
|
|
||
| Git will be used to download the source code, and CMake will be used to generate the build files. | ||
| ```bash | ||
| sudo apt-get install git cmake build-essential liblua5.2-dev libgmp3-dev libmysqlclient-dev libboost-system-dev libboost-iostreams-dev libboost-filesystem-dev libpugixml-dev libcrypto++-dev |
| mkdir build && cd build | ||
| cmake .. | ||
| ``` | ||
| ## Build |
There was a problem hiding this comment.
Try to leave one empty line above every header.
| @@ -0,0 +1,201 @@ | |||
| # Getting started | |||
| Rent a Ubuntu Server 18.04 or higher from a trusted hosting company such or install for the sake of learning experience Ubuntu Server 18.04 or higher in VirtualBox. | |||
There was a problem hiding this comment.
Technically, WSL could be used on Windows as well instead of VirtualBox.
There was a problem hiding this comment.
Using WSL as server would cause many people with a lot of issues. I been through issues with it as well. Giving more options would give people a better feeling for themselves to pick the way they find to use the best. VirtualBox is given as example since its great for new people. When you've made a mistake you delete the VM and create a new one and start over. We are making guides for people which has no knowledge.
There was a problem hiding this comment.
VirtualBox also empowers them with advanced solutions, such as using USB passthrough to a separate Wifi dongle. This ensures Windows is not interfering, in any manner whatsoever, with the TFS servers internet connectivity. An important elimination of complexity in the typical diagnosing self-hosted login issues thread in the support forum. Though admittedly outside the scope of this particular guide.
Still, if both options are presented, VirtualBox should be preferred, because it presents the full native Linux environment. And if there is an advanced guide on the matter they follow later, it would definitely introduce them to VBox's seamless mode, which is a game changer for really experiencing the power of a Linux desktop environment without leaving their comfortable safety of Windows. Call it optimism for the best result.
| # Getting started | ||
| Rent a Ubuntu Server 18.04 or higher from a trusted hosting company or install for the sake of learning experience Ubuntu Server 18.04 or higher in VirtualBox. | ||
|
|
||
| Once you're set we will start by accessing our server. If you're on windows you should get putty(https://www.putty.org/), if you're on macOS or Linux you can use the terminal which is standard available. With putty just follow the screen ( insert your domain/ip-address and click ok ) for macOS and linux users type: |
There was a problem hiding this comment.
Lot's of typos:
PuTTYnotputty- No spaces inside
(and) IP addressnotip-addressclick "OK"notclick okLinuxnotlinux
There was a problem hiding this comment.
You can use a link to PuTTy instead
| `username example => root | ||
| domain/ipaddress example => yourdomain.com or 127.0.0.1` | ||
|
|
||
| Now you will be prompted for your password (if in putty you will be prompted for the password as soon you click on Open) Insert your password and presh enter (you will not see what you type, so make sure you type your password in the right order). Now we are in our server :) |
There was a problem hiding this comment.
PuTTY misspelled
Missing full stop at the end of sentence.
presh -> press
| Now you will be prompted for your password (if in putty you will be prompted for the password as soon you click on Open) Insert your password and presh enter (you will not see what you type, so make sure you type your password in the right order). Now we are in our server :) | ||
|
|
||
| ## Update and Upgrade the system | ||
| The first thing we will do is updating our Ubuntu Server with the following command |
|
|
||
| Now you will be prompted for your password (if in putty you will be prompted for the password as soon you click on Open) Insert your password and presh enter (you will not see what you type, so make sure you type your password in the right order). Now we are in our server :) | ||
|
|
||
| ## Update and Upgrade the system |
There was a problem hiding this comment.
Missing newline after header
| ```bash | ||
| sudo apt update && sudo apt upgrade -y | ||
| ``` | ||
| We are using 'sudo' since I do not know if you're running as root user or as regular user. When you're logged in as regular user. No problem! Just enter your password when the terminal asks for your password. With the command above you will update the connected repository's the server is connected to and when the server is done updating the repository's it will directly upgrade all the packages which were updated. |
There was a problem hiding this comment.
Something here doesn't flow/make sense.
The guide should specify whether to work as root or regular user.
|
|
||
| Second we want to do is enabling php in our nginx server and setting the configuration just as we want. So we will be going to edit our nginx config. Now we need to install a command line text editor called "vim". After that we installed it we will directly open the configuration file. | ||
| ```bash | ||
| sudo apt install vim -y && sudo vim /etc/nginx/sites-available/default |
There was a problem hiding this comment.
No need to chain commands, just put them in two separate lines.
Explaining what && does is unnecessary here, so let's just not use it.
| sudo apt install vim -y && sudo vim /etc/nginx/sites-available/default | ||
| ``` | ||
|
|
||
| I am going to give you a few options in the configuration. Underneath here you will find the default configuration file of nginx. ( I only took the part of the config file we are in need to use and left out all the comments which we do use in this tutorial ) |
There was a problem hiding this comment.
| I am going to give you a few options in the configuration. Underneath here you will find the default configuration file of nginx. ( I only took the part of the config file we are in need to use and left out all the comments which we do use in this tutorial ) | |
| Below you will find the default configuration file of nginx (only relevant parts are shown, comments ommitted). |
There was a problem hiding this comment.
Try to avoid first-person narrative ("I did"), author is not important here.
|
|
||
| ## Changing the web-root | ||
|
|
||
| We can change the 'root' directory of the website folder, if you're only using your server as root leave it in '/var/www/html'. When using it as for example 'john' you can change the directory to your default directory when you come when you login which is: '/home/john' in the default directory of john you can do 'mkdir www' to create a directory for the website and set: '/home/john/www' on line '5' instead of '/var/www/html'. |
There was a problem hiding this comment.
On Linux, the term in use is directory, not folder. Since this is technical documentation, you have to try to use proper terms.
|
|
||
| I am going to give you a few options in the configuration. Underneath here you will find the default configuration file of nginx. ( I only took the part of the config file we are in need to use and left out all the comments which we do use in this tutorial ) | ||
|
|
||
| ## Changing the web-root |
There was a problem hiding this comment.
Generally this section is not "necessary" as most people and guides do indeed keep the web root in /var/www/ / /var/www/html/ and rarely ever people need to put more than one "website" on a VPS for OTS.
|
|
||
| Directly copy'd from the TFS github wiki(https://github.com/otland/forgottenserver/wiki/Compiling-on-Ubuntu): | ||
|
|
||
| ## Install the required software |
There was a problem hiding this comment.
The content from this line is duplicated - it's already documented in the TFS wiki, which we might move over to the OTS Guide.
It's not wrong but it will quickly get outdated. It's best to link to the wiki which is kept up to date.
In fact, the package list is already outdated below and the instructions wouldn't work.
Created a book for setting up a complete webserver on linux