Server Setup¶

Requirements¶

Savee API¶

Savee Webapp¶

Preparing the Server¶

Debian Installation¶

The first step of the installation is to install the Debian distribution of Linux. Simply follow the system's installation wizard, but whenever encoutering the disk setup, it is recommended to utilize the whole disk and to put all files in one partition.

At the end of the Debian installation, make sure not to install the Desktop environment and GNOME. And also do install the SSH module.

Changing the IP Address¶

After successfully installing Debian it is recommended to set your IP address to static. You can do this by entering:

nano /etc/network/interfaces

into your command line, which will open up a text editor, where you can edit your server's interfaces.

Once there, if you change this line:

iface {interface name} inet dhcp

to this:

iface {interface name} inet static
  address {IP address}
  netmask {Subnet mask}
  gateway {Gateway address}
  dns-nameservers {DNS address}

and save the file by pressing CTRL+O and ENTER and then by pressing CTRL+X to exit, you will have successfully changed the IP address from DHCP to static.

Restarting the Networking Service¶

Even if you have changed the IP address in the interfaces file, it is required to reload the networking service for the system to take the changes into account. You can achieve this by simply rebooting the system.

reboot

systemctl restart networking.service

Installing SUDO¶

Installing SUDO allows root access after connecting with ssh to allow better remote control of the Savee server.

First, it is recommended to update the package source list by using:

apt update

Then, you can install SUDO by typing:

apt install sudo

However, to get root priviliges from an administrator account, you have to add the account into the sudo group. You can do this by:

adduser ${username} sudo

Then after logging out and then logging back in, the account will have access to the sudo command.

Continuing with SSH¶

From this point on, it is possible to carry on with the setup remotely using SSH from a remote machine.

Preparing the "/srv" folder¶

After logging in from your admin account, you should transfer the ownership of the /srv folder from the root account to the admin account. This is done by using this command:

sudo chown ${username} /srv

Installing Docker¶

Docker is an essential part of running Savee. This means, that the Savee server has to have Docker installed. The installation of Docker is as easy as following the official Docker for Debian documentation.

The first step of installing Docker is ensuring no old Docker versions are installed on the machine. This can be verified by a command as shown here in the documentation.

After ensuring the system is clean of any old Docker versions, you can carry on installing Docker as described here in three quick steps.

Finally, it is recommended to follow these post installation steps to configure the Linux server to work better with Docker. The post-installation steps mainly consist of adding your server's admin account to the "docker" group to allow the control of Docker through your admin account without using root privileges.

You can achieve this by using this command:

sudo adduser ${username} docker

and then by logging out and logging back in to ensure the re-evaluation of the admin account's group memberships.

To test if you installed Docker correctly, you can run:

docker run hello-world