Nubla Dashboard

a simple dashboard to access Nubla services

Develop

1. Launch an authorization server
2. Initialize a .env file, set and customize the parameters defined in the configuration paragraph
3. If needed, install the virtual environment:

poetry install

4. Compile the translations:

pybabel compile --directory nubla_dashboard/translations

5. Run the web server:

poetry run honcho start

6. Go to http://localhost:5555

Configure

Either:

• edit a .env file in your repository
• pass the following parameters as environment variables
• set those parameters in a .toml file, and pass the file path with the CONFIG environment variable

# Flask configuration
SECRET_KEY="very-secret"
PREFERRED_URL_SCHEME="http"
SERVER_NAME="localhost:5555"

# Nubla dashboard configuration
URL_AUTH_SERVER="http://localhost:5000"
URL_MAIL="https://mail.mydomain.tld"
URL_CLOUD="https://cloud.mydomain.tld"
URL_IM="https://messages.mydomain.tld"
COLOR_DARK="#323232"
COLOR_LIGHT="#F4F4F4"
COLOR_PRIMARY="#E83441"
COLOR_SECONDARY="#8867B2"
COLOR_ACCENT="#F1B418"
NAME="Nubla"
SLOGAN="The best website in the whole universe"

On production environment, you may want to configure the OAUTH2 credentials. This should not be necessary for development environments.

OAUTH_CLIENT_ID="my-client-id"
OAUTH_CLIENT_SECRET="my-client-secret"

If you want to restrict services access to some groups, you can use the following parameters.

GROUP_MAIL="mail"
GROUP_CLOUD="cloud"
GROUP_IM="im"

You can force a locale with:

LANGUAGE="fr"

Déploiement

• créer une nouvelle version avec git tag <version>
• dans yserversetup, mettre à jour la variable nubla_dashboard_version
• dans yserversetup, deployer le tag nublapro