/install-cloud-server

Script collection to setup an 1&1 cloud server with ubuntu 16.04, ubuntu 18.04, Debian 8.x or Debian 9.x and nextcloud.

Primary LanguageShellGNU General Public License v3.0GPL-3.0

install-cloud-server

Script collection to setup a cloud server with Ubuntu 16.04, Ubuntu 18.04, Debian 8 or Debian 9. Installs and sets up all required packages for nextcloud. Finally installs nextcloud.

Optionally installs libreoffice online. Optionally installs additional nextcloud apps.

Requirements

The scripts collection is tested for an 1&1 cloud server, Ubuntu 16.04 and Ubuntu 18.04, 64-bit, standard installation, Debian 8 and Debian 9, 64-bit, standard installation.

  1. For the scripts to work, you have to setup such a server as descripted in my blog at https://blog.emrich-ebersheim.de/2016/09/05/11-cloud-server-unter-ubuntu-16-04-1-lts-teil-1-server-erstellen/ (in german). For testing purposes a Cloud Server S incl. one public IP is sufficient.
  2. You have to point a DNS Entry for the host itself and a DNS Entry for the nexcloud instance to the public IP you've got.
  3. If you want to install libreoffice online you need a third DNS Entry for the online office.

It's recommended to use subdomains of the same domain for online office and nextcloud, for example: office.mydomain.tld and cloud.mydomain.tld.

Functions

  • Update the system
  • Set system hostname and domain
  • Setup a privat netwerk interface [optional]
  • Append host entries to /etc/hosts [optional]
  • Configure sshd for publickey authentication
  • Copy authorized_keys to ~/.ssh/
  • Copy pregenerated ssh host keys to ~/.ssh/
  • Setup 1&1 Backup Manager [optional]
  • Install some basic software packages
  • Setup redis
  • Replace MySQL with MariaDB 10.2
  • Setup apache2
  • Setup letsencrypt using the certbot client from ppa:certbot/certbot
  • Setup postfix using tls
  • Setup docker
  • Setup munin
  • Setup phpmyadmin
  • Setup php7.0-fpm, php7.1-fpm and php7.2-fpm
  • Install nextcloud prerequisites (including the necessary php 7.0, phpi 7.1 and phpi 7.2 modules)
  • Install nextcloud using php 7.2
  • Install libreoffice online [optional, seperate script]
  • Install additional nextcloud apps [optional, seperate script]

Configuration

Before you start, you have to customize the configuration! It's recommended to download the script collection to a different host. Unpack the archive there as user root or using sudo and the tar commandline options "-p --no-same-owner". Adjust the configuration and if you want to use the 1&1 Backup Manager, please copy the installer into the backupmanager directory, see notes below. If you want to install libreoffice online, you may copy the libreoffice online package to the packages directory too. But this may also be done later on, see below. After finishing the configuration, repackage the whole directory as user root or using sudo to a tar archive and transfer the archive to your new host using scp.

Most Important:

Please copy a file authorized_keys containing your ed25519 ssh public key(s) into the directory config/ssh. If you want to use pregenerated ssh keys for the account at your new host, please copy the keys into the directory config/ssh too.

Hostname

Please copy the file config/hostname.sh.example to config/hostname.sh and adjust the variables MY_HOSTNAME and MY_DOMAIN to the actual values.

Private network

Please copy the file config/network.sh.example to config/network.sh and adjust to your needs. If you don't use a private network, set the variable SETUP_PRIVATE_NETWORK to "0", that's sufficient.

/etc/hosts

Please copy the file config/etc.hosts.part.example to config/etc.hosts.part and replace the conent with your host entries. This is especially usefull if you have a private network.

apache and letsencrypt

Please copy the file config/letsencrypt.sh.example to config/letsencrypt.sh and adjust to your needs. The variable ADMINHOST defines the FQDN or an IPv4 address of an administration host. The access to the Apache webserver server-status, server-info, apache2-doc, phpinfo and phpmyadmin pages will be restrictet to local and the administration host.

postfix

Please copy the file config/postfix.sh.example to config/postfix.sh and adjust to your needs.

nextcloud

Please copy the file config/nextcloud.sh.example to nextcloud.sh and adjust to your needs.

libreoffice online (optional), seperate script install-lool.sh

Please copy the file config/lool.sh.example to config/lool.sh and adjust to your needs. If you want to use this functionality, you have to build a libreoffice online package beforehand, see https://github.com/RainerEmrich/build-lool. The built package has to be copied to the packages directory.

Execution

Transfer the configured script collection archive to your new host. Unpack in your home directory or to another suitable location.

Before you start the script, you should have some additional info at hand:

  • Backup account name, password and an encrytion key, if you want to install the 1&1 Backup Manager. You have to configure a backup account in the 1&1 cloud panel beforehand.
  • A new password for the MariaDB "root" user.

Start the script install-server.sh.

  1. The first action the script executes, is to check wether we are on an ubuntu 16.04 system. If not we stop. Then we compare the current hostname to the configured one. If the current hostname is not "localhost" or the configured one we stop. If the current hostname is "localhost" we continue execution.
  2. We write a startup line for starting the script to ~/.bashrc, so the script is started again at login.
  3. We update the system and install the patchutils, which are required for the script collection to function.
  4. We set hostname and mailname and add some aliases to .bash_aliases.
  5. If requested, we setup the private network interface.
  6. We append the content of config/etc.hosts.part to /etc/hosts.
  7. We configure the ssh daemon to use ed25519 keys and publickey authentication. We copy the authorized_keys file and existing ssh keys from the config/ssh directory to ~/.ssh/.
  8. We reboot the system.
  9. At login we resume execution.
  10. If the 1&1 Backup Manager installer is available, we install and setup the Backup Manager. Additionally some scripts for more convenient usage of the Backup Manager are copied to ~/bin/ and correspondent aliases are added to ~/.bash_aliases.
  11. We install some commonly used software: software-properties-common, update-notifier-common, apt-show-versions, dnsutils, git, man-db, manpages, vim, vim-doc, vim-scripts and haveged.
  12. We install and setup redis for use with nextcloud.
  13. We replace the default MySQL database server with MariaDB 10.2.
  14. We reboot the system a second time.
  15. At login we resume execution by installing the apache2 webserver from the ppa of Ondřej Surý.
  16. Install certbot letsencrypt client, get a first certificate and configure apache2.
  17. Setup postfix using tls.
  18. Setup docker.
  19. Setup munin for server monitoring, only accessible from the administration host.
  20. Setup phpmyadmin from the ppa of Michal Čihař (nijel). Acces is restricted to local and the administration host. Additionally scripts are copied to ~/bin/ for enabling and disabling the phpmyadmin page completely and to enable or disbale root login for phpmyadmin.
  21. Install and configure php7.0-fpm, php7.1-fpm and php7.2-fpm.
  22. Install the remaining prerequisites for nextcloud.
  23. Install nextcloud.
  24. We remove the startup line from ~/.bashrc.
  25. Optionally install libreoffice online using the install-lool.sh script, has to be started manually.
  26. Optionally install additional nextcloud apps using the install-apps.sh script, has to be started manually.

Running install-server.sh takes about 12 minutes. Last tested on 22nd of March 2017. Running install-lool.sh takes additional 2 minutes. Most of the time is used to unpack the libreoffice online package.

Result

You get a 1&1 Cloud Server running nextcloud in less than 15 minutes.

If you have installed the 1&1 Backup Manager, you may enable the preinstalled cronjob in the root users crontab for daily backups. You may add directories to backup by using backup.add /foo/bar for example. The backup cronjob calls the mysql-backup.sh script in the ~/bin directory before starting the backup. This script backups all non-system databases to the directory /root/database-backup keeping the last 30 backups at most. If you want to include this directory in the backup add it to the Backup Manager using "backup.add /root/database-backup".

If you have installed the libreoffice online package and want to use it in nextcloud, you have to enable the "Collabora Online" app in nextcloud. When you have the app enabled, you have to set the "Collabora Online Server" on the nextcloud admin page. Depending on your configuration, this should be something like "https://myoffice.mydomain.tld".

Given your domain is "mydomain.tld", your host is "myhost", your nextcloud is "mycloud" and your online office is "myoffice", you find the following webpages running:

The phpmyadmin page is disabled by default. You may enable the page by using ~/bin/phpmyadmin.on.sh. The script ~/bin/phpmyadmin-off.sh disables the page again.

I'm sure there is a lot of room for improvements. Don't hesitate to contact me.

The script collection is based on my two article series about 1&1 cloud server on https://blog.emrich-ebersheim.de

Status

Last tested with Ubuntu 16.04, Debian 8 and Debian 9 on 13th of April 2018.