Configure Dashboard

After you install the Presslabs Dashboard and paste the install link in your browser, you’ll be redirected to a configuration wizard to setup further details. You can configure these settings now or skip them and configure them later from the Dashboard’s System Settings . Skipping the configuration steps is a good approach if you want to check out the Dashboard as soon as possible to see what it has to offer, but they need to be followed for the Dashboard to be fully operational.

NOTE

• If you skip the configuration steps, keep in mind that the installation link regenerates every 2 hours and you’ll have to go back to the Presslabs Dashboard App on GCP and recopy the install link to access the Dashboard again.
• The installation link is automatically disabled when you login for the first time with your Auth0 or Google OAuth credentials.
• If you somehow mess up your credentials, you can reactivate the installation link to fix them.

If you skip the configuration steps, you can go ahead and create your first site .

Configure Dashboard through wizard

Step 1: Configure the Admin User

The first step is to enter the email address of the person who’ll be the admin of the Presslabs Dashboard. You can add more admin users later from the Dashboard if you need so, see Admin Users .

NOTE

The admin users are the only ones that will be able to create and delete organizations and modify the Dashboard settings.

Step 2: Configure the Authentication Settings

The authentification to the Presslabs Dashboard can be done through Auth0 or Google OAuth. Follow the tutorial from Setup Authentication to see how to setup one method or another. You’ll need to copy the following fields from your Auth0/Google application and paste them in the installation wizard:

• OIDC Issuer URL, make sure when you copy the issuer URL that you have the full domain and that it ends in /, e.g. https://presslabs-dashboard.eu.auth0.com/ or https://accounts.google.com/
• OIDC Client ID

Then you need to press on Verify Configuration to validate your credentials.

Step 3: Configure Let’s Encrypt

Here you’ll need to enter:

• Let’s Encrypt Account Email: type the email that will be used to create Let’s Encrypt certificates; you’ll receive notices on this email in case your certificates expire
• Let’s Encrypt Server: this is the ACME server URL for Let’s Encrypt certificates, it’s automatically filled in for you; for staging environments you can use https://acme-staging-v02.api.letsencrypt.org/directory, see more on Let’s encrypt docs

The generation of the certificates may take up to 10-15 minutes.

Step 4: Install Config Connector

NOTE

The Config Connector add-on shouldn’t be used for now, use instead our documented installation steps above.

To install the Config Connector press onInstall button.

Login into your Google Cloud account and you’ll be redirected to enter the Cloud Shell and clone the dashboard-config-connector repo:

NOTE

You need to check that you Trust this repository, otherwise your credentials won’t be available in this session and you’ll need to run gcloud auth to authenticate.

Then you’ll have one more popup to Authorize Cloud Shell:

Then, in Google Cloud Console, enter the directory and run following command:

./install.sh

That’s it, you’ve successfully configured the Presslabs Dashboard. All that’s left to do now is press on Finish Installation button.

Now go ahead and create your first site .

Configure Dashboard from System Settings

If you’ve skipped some of the configuration steps or even all of them, you can always finish configuring them or change your options from the Dashboard’s System Settings.

NOTE

Only the admin users can manage the System Settings.

Go to the account avatar (on upper right corner) and select System Settings.

Authentification

The authentification to the Presslabs Dashboard can be done through Auth0 or Google OAuth. Follow the tutorial from Setup Authentication to see how to setup one method or another. You’ll need to copy the following fields from your Auth0/Google application and paste them in the installation wizard:

• OIDC Client ID
• OIDC Issuer URL, make sure when you copy the issuer URL that you have the full domain and that it ends in /, e.g. https://presslabs-dashboard.eu.auth0.com/ or https://accounts.google.com/

Then you need to press on Verify Configuration to validate your credentials.

Let’s Encrypt

Here you’ll need to enter:

• Let’s Encrypt Account Email: type the email that will be used to create Let’s Encrypt certificates; you’ll receive notices on this email in case your certificates expire
• Let’s Encrypt Server: this is the ACME server URL for Let’s Encrypt certificates, it’s automatically filled in for you; for staging environments you can use https://acme-staging-v02.api.letsencrypt.org/directory, see more on Let’s encrypt docs

The generation of the certificates may take up to 10-15 minutes.

Config Connector

NOTE

The Config Connector add-on shouldn’t be used for now, use instead our documented installation steps above.

To install the Config Connector press onInstall button:

Login into your Google Cloud account and you’ll be redirected to enter the Cloud Shell and clone the dashboard-config-connector repo:

NOTE

You need to check that you Trust this repository, otherwise your credentials won’t be available in this session and you’ll need to run gcloud auth to authenticate.

Then you’ll have one more popup to Authorize Cloud Shell:

Then, in Google Cloud Console, enter the directory and run following command:

./install.sh

When the installation is finished, go to the Config Connector page on System Settings and you’ll see it was successfully installed.

That’s it, you’ve successfully installed the Config Connector.

Admin Users

From this page an admin user can add or delete other admin users. To add a new admin user, simply enter their email address and press Create admin user.

The admin users are the only ones that can:

• see all organizations
• create an organization
• see the System Status
• modify System status