From 23091bdc612c250e249adfee3e4ebc6f7309c621 Mon Sep 17 00:00:00 2001 From: Mo8it Date: Sat, 19 Nov 2022 19:39:27 +0100 Subject: [PATCH] Remove outdated server_setup documentation --- docs/server_setup.adoc | 181 ----------------------------------------- 1 file changed, 181 deletions(-) delete mode 100644 docs/server_setup.adoc diff --git a/docs/server_setup.adoc b/docs/server_setup.adoc deleted file mode 100644 index 3081f2d..0000000 --- a/docs/server_setup.adoc +++ /dev/null @@ -1,181 +0,0 @@ -= Server setup - -== Server specifications -The setup was tested on Debian 11.3. It should also work on other Debian based Linux distributions. For distributions not based on Debian, some modifications might be necessary in the setup script `server_setup.py`. - -Two CPU cores should be more than enough for the server. - -The needed disk space depends on the database size after long usage. - -== Setup -. Root setup - -.. `ssh` as `root`: -+ -[source,bash] ----- -ssh root@SERVER_NAME ----- - -.. Run the following (as root): -+ -[source,bash] ----- -# Install needed packages -apt update -apt install sudo python3 git -y - -# Add a sudo user with the name 'admin' -sudo useradd admin -sudo usermod -aG sudo admin -sudo mkhomedir_helper admin - -# Enter a new password for 'admin' -sudo passwd admin - -# Break the SSH connection -exit ----- - -. Admin setup - -.. `ssh` again with the new user `admin` and password: -+ -[source,bash] ----- -ssh admin@SERVER_NAME ----- - -.. Clone the repository with `git clone` into `/home/admin/advlabdb`. - -.. `cd` into the new cloned repository: -+ -[source,bash] ----- -cd ~/advlabdb ----- - -.. Settings - -... Copy the example file for the settings: -+ -[source,bash] ----- -cp settings_example.ini settings.ini ----- - -... Enter your SERVER_NAME in `settings.ini`. - -.. Timezone - -... List all available timezones: -+ -[source,bash] ----- -sudo timedatectl list-timezones ----- - -... Choose your timezone and enter it as showed while listing as your timezone using this command (with Europe/Berlin as example): -+ -[source,bash] ----- -sudo timedatectl set-timezone Europe/Berlin ----- - -.. Edit the file `/etc/hostname` with `sudo` such that its content is only your SERVER_NAME. - -.. Edit the file `/etc/hosts` with `sudo` such that the first two lines are: -+ -[source,bash] ----- -127.0.0.1 localhost -127.0.1.1 SERVER_NAME SERVER_NAME_WITHOUT_DOMAIN ----- - -.. Run the server setup script: -+ -[source,bash] ----- -python3 advlabdb/scripts/setup/server_setup.py ----- - -.. The setup script will cause the server to reboot at the end. After the reboot ssh again: -+ -[source,bash] ----- -ssh admin@SERVER_NAME ----- - -.. Change working directory to the repository: -+ -[source,bash] ----- -cd ~/advlabdb ----- - -.. Run database initialization script: -+ -[source,bash] ----- -poetry run python3 manage.py setup init-db ----- - -.. *Done!* Now go to your SERVER_NAME using a browser to verify that everything is working. - -== SSH configuration -IMPORTANT: This section is important for security! - -=== SSH key -For the authentication using SSH, generate a SSH key pair on your _own machine_ (not on the server) and upload the public key to the server using the command `ssh-copy-id`: - -[source,bash] ----- -ssh-copy-id -i KEY.pub admin@SERVER_NAME ----- - -=== SSH configuration file -On the server, open the file `/etc/ssh/sshd_config` with in an editor like `nano` or `vim` with `sudo`, then do the following: - -. Disable login to root -+ -Change -+ ----- -PermitRootLogin yes ----- -+ -to -+ ----- -PermitRootLogin no ----- - -. Disable login with password -+ -WARNING: Make sure that you did upload your public key to the server for the SSH authentication! Otherwise, you will not be able to login to the server after this change. -+ -Change -+ ----- -#PasswordAuthentication yes ----- -+ -to -+ ----- -PasswordAuthentication no ----- - -. Disable X11Forwarding -+ -Change -+ ----- -X11Forwarding yes ----- -+ -to -+ ----- -X11Forwarding no -----