2.3.1 Configure

There are a few values that need to be configured before starting the platform:

Domain names: the domain name for the server, the web application and the nextcloud instance.
The domain name for the test SMTP server. This is used to test the platform and should not be used in production. You’ll need to configure your own SMTP server as described below.
SMTP server configuration: the host and credentials to connect to an SMTP instance.

For example, if you own a company.tech domain, you’ll configure your services as follows:

SERVER_URL=backoffice.colmena.company.tech
CLIENT_URL=colmena.company.tech
NEXTCLOUD_URL=nextcloud.colmena.company.tech
SMTP_SERVER_URL=mail.colmena.company.tech

Note that the backoffice, nextcloud and mail, as well as the .colmena subdomain names, are optional, and you can change them to whatever name you want to make your services discoverable at.

Once you determine which are your domains, configure the following security setting:

# Original value, allows any host
# BACKEND_ALLOWED_HOSTS=*
# Change to the following:
# Allows any subdomain under the .company.tech domain.
BACKEND_ALLOWED_HOSTS=.company.tech

You’ll also need to configure your SMTP server credentials to setup the mailing service.

# SMTP Server configuration
EMAIL_FROM=colmena@company.tech
EMAIL_HOST=smtp.company.tech
EMAIL_PORT=465
EMAIL_HOST_USER=admin@company.tech
EMAIL_HOST_PASSWORD=some-password

Finally, you’ll need to setup a username and a password for the superadmin user. Please modify the following variables to a value of your preference:

For testing purposes you can leave all this values as they are. Then you’ll use these very same credentials to access each platform service..

# This are the email and password values to access the backoffice
SUPERADMIN_PASSWORD=some-password
SUPERADMIN_EMAIL=superadmin@anything.org
# This are the email and password values to access the nextcloud instance.
NEXTCLOUD_ADMIN_USER=superadmin
NEXTCLOUD_ADMIN_PASSWORD=superadmin
# This are the username and password to access the postgres admin instance. Leave it as it is if you don't care about security.
PGADMIN_DEFAULT_EMAIL=admin@colmena.media
PGADMIN_DEFAULT_PASSWORD=admin

Due to a current limitation, the NEXTCLOUD_ADMIN_USER and the left side of the SUPERADMIN_EMAIL should be called the same. In this example both are called superadmin, please respect this constraint.

Once you considered your platform configuration, use the CLI to setup the values.

colmena configure environment

This will prompt a text editor. Update the values shown above and exit when ready.