eLAND installs on a VPS with Dokku.
See the Dokku installation guide.
Install Dokku on a VPS with a fresh Ubuntu 18.04,
Domains: don't set a global domain, but set a domain for the app with a wildchart
(all dokku commands are on the server)
dokku domains:set app-name *.my-domain.com
Create app, install postgres and redis plugins and bind them to the app (see Dokku guide).
Configure nginx to allow bigger uploads (for documents)
sudo su - dokku mkdir /home/dokku/appname/nginx.conf.d/ echo 'client_max_body_size 10M;' > /home/dokku/appname/nginx.conf.d/upload.conf exit sudo service nginx reload
A CNAME record with wildcard should point to the Dokku app url.
Subdomains (systems) match schemas
The subdomain part of the url matches the database schema name.
flupke.my-domain.com matches to database schema
Set the overall domain with:
dokku config:set appname OVERALL_DOMAIN=my-domain.com
Create a IAM user on AWS with access only to S3. Then create a bucket in your region and set the environment variables.
dokku config:set AWS_S3_BUCKET=bucket_name AWS_S3_REGION=eu-central-1 dokku config:set AWS_ACCESS_KEY_ID=aaa AWS_SECRET_ACCESS_KEY=bbb
SMTP mailserver (e.i. Amazon Simple Email Service)
From mail addresses
MAIL_FROM_ADDRESS: a mail address when a reply-to address has been set.
MAIL_NOREPLY_ADDRESS: a notification mail you can not reply to
MAIL_HOSTER_ADDRESS: used for the request-hosting form.
Mail is sent only from
These addresses should be set up for DKIM in the mailserver.
Coordinates of addresses are looked up and cached from the Google geocoding service in order to show the location on maps. At maximum every 2 minutes a request is sent to the API in order not to hit the daily free limit. You need to get a key from Google
and put the key in the environment variable
The geocoding service can be blocked by setting
GEO_BLOCK to 1.
Hoster Contact Form
The hoster can set up general contact forms to let people contact him/her: The Domain of a request-hosting form can be set with:
- domain is the server name of the contact form. All uppercase and dots become double underline.
- name: The name of the contact form or the context.
- link: The link to bring the user back.
Redirects from.domain.net to to.domain.net A double underscore in the key represents a dot in the domain.
Other environment vars
TIMEZONE: defaults to 'Europe/Brussels'
MASTER_PASSWORD: sha512 encoded password for 'master' -> gives admin access to all Systems.