From 6563f7764bf85e4aec1ebc34777f628d7c41daec Mon Sep 17 00:00:00 2001 From: thilo Date: Wed, 7 Aug 2019 22:52:32 +0200 Subject: [PATCH 1/2] suggested README addtions --- README.md | 60 ++++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 57 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 02ddc30..1b156b8 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Ecloud Selfhosting (Beta) -This project allows you to install ecloud services on your own server. It is the same +This project allows you to install ecloud services on your own server. It is a similar setup that is used on [ecloud.global](https://ecloud.global). The project is currently in beta. You should have some experience with Linux server @@ -25,6 +25,8 @@ For the setup without OnlyOffice, requirements are a bit lower: Disk space only refers to the basic installation. You will need additional space for any emails, documents and files you store on the server. +Additionally you will need to have a minimum of one domain registered. + ## Installation ### Create Ubuntu VPS @@ -33,7 +35,14 @@ The project should work with any Ubuntu VPS. Suggestions include [Hetzner](https or [OVH](https://www.ovh.co.uk/vps/vps-ssd.xml). Hosting at home is also possible in principle, but you will probably have problems with sending email (most providers will classify your email as spam). -First, create your VPS and point the domain at it. Then set the reverse DNS to the same domain +The below example will use `yourdomain.com` to explain the (initial) DNS setup you need to have for this to work. + +TBD this is maybe a bit too technical? +First, create your VPS (note down its IP, 1.2.3.4 in this example) and create two A records in the zone file of your domain on your DNS server (or the corresponding webui of the domain registrar): + - A record from @ -> 1.2.3.4 (@ stands for the main domain itself - but not as a placeholder in this text, literally use @!) + - A record from mail -> 1.2.3.4 (CNAME would NOT be sufficient!) + +Then set the reverse DNS of 1.2.3.4 to mail.yourdomain.com. (this is usually possible in the VPS settings on the hoster's website). In the following text, `$DOMAIN` refers to the domain that you configured for your selfhosting server. @@ -45,7 +54,51 @@ Login to server as root. Execute this command and follow its on-screen instructi ``` $ ssh root@$DOMAIN # wget https://gitlab.e.foundation/e/infra/bootstrap/raw/master/bootstrap-generic.sh -# bash bootstrap-generic.sh https://gitlab.e.foundation/e/priv/infra/compose +# TBD this pasth will change once made public (/priv/): +# bash bootstrap-generic.sh https://gitlab.e.foundation/e/priv/infra/ecloud-selfhosting +``` +The setup script will ask you to input some details of your setup (like your domain name) and to setup additional DNS records (the two A records plus the PTR record were set already above). + +Example session for yourdomain.com: +``` +bash bootstrap-generic.sh https://gitlab.e.foundation/e/priv/infra/ecloud-selfhosting +[...] +Resolving deltas: 100% (681/681), done. +System update and packages installation .. +[...] +Total run time: 148.039 s +Enter your mailserver (management) domain (e.g. domainA.com): +yourdomain.com +Optionally enter additional domain(s) (comma separated, no white spaces) to handle mail for (e.g. domainB.com,domainC.com) or just press enter if you need none: + +Enter alternative email: +someone@example.org +Do you want to install OnlyOffice? [y/n] +n +Your management domain is: yourdomain.com +Your additional domains are: [N/A] +Is this correct? (yes or no) yes +================================================================================================================================= +Please setup the following DNS records for your domains before you proceed (subsequent steps will fail if a record is missing): +================================================================================================================================= + +RECORD | HOST | VALUE | Priority +------ | ---- | ----- | -------- +A | mail.yourdomain.com | | - +A | yourdomain.com | | - +MX | yourdomain.com | mail.yourdomain.com | 10 +PTR(For reverse DNS) | | mail.yourdomain.com | - +CNAME | autoconfig.yourdomain.com | mail.yourdomain.com | - +CNAME | autodiscover.yourdomain.com | mail.yourdomain.com | - +CNAME | spam.yourdomain.com | mail.yourdomain.com | - +CNAME | welcome.yourdomain.com | mail.yourdomain.com | - +================================================================================================================================= +================================================================================================================================= + +Type 'yes' and hit ENTER to confirm that you have setup DNS properly before we continue: +yes +[...] + ``` ### Manual account creation @@ -68,6 +121,7 @@ You can find login information for these services by running `bash /mnt/repo-bas - `welcome.$DOMAIN`: Allows users to sign up for a new account (you can create signup links with `bash /mnt/repo-base/scripts/generate-signup-link.sh`) - `office.$DOMAIN`: Create and edit office documents ([OnlyOffice](https://www.onlyoffice.com/)) + (only when you answered yes to the question "Install OnlyOffice?" during setup obviously) ## Administration -- GitLab From 82b2dbf5c1bd9f9f47c776a90436c1c0a6d4e2f5 Mon Sep 17 00:00:00 2001 From: thilo Date: Wed, 7 Aug 2019 22:53:11 +0200 Subject: [PATCH 2/2] suggested README addtions --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1b156b8..922e436 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ setup that is used on [ecloud.global](https://ecloud.global). The project is currently in beta. You should have some experience with Linux server administration if you want to use it. The current setup makes updates difficult, so manual intervention might be necessary. In the future, we will switch to Ansible -for deployment to simplify this. +for deployment to simplify this. (TBD remove this once ansible is in use) ## Requirements -- GitLab