Configure Dashboard

You can configure the settings for the Presslabs Dashboard from the configuration wizard that appears when you install it, or later from System settings.

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 expires 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.

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.

Configure the Dashboard Admin User

Step 2: Configure the Authentication Settings

The authentification to the Presslabs Dashboard can be done through Auth0 or Google OAuth. Follow the tutorial from Create Dashboard Credentials 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

Configure Dashboard authentication

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

Configure Let's Encrypt

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

Step 4: Install Config Connector

To install the Config Connector press onInstall button.

Install Google Config Connector

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

Clone dashboard-config-connector repo in Cloud Shell

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:

Authorize Cloud Shell

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

./install.sh

Google Cloud Shell

When the installation is finished, refresh the page on the installation wizard and you'll see the Config Connector was successfully installed.

Config Connector installed

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.

Dashboard System Settings

Authentification

The authentification to the Presslabs Dashboard can be done through Auth0 or Google OAuth. Follow the tutorial from Create Dashboard Credentials 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/

Configure Dashboard authentication

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

Configure Let's Encrypt

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

Config Connector

To install the Config Connector press onInstall button:

Install Google Config Connector

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

Clone dashboard-config-connector repo in Cloud Shell

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:

Authorize Cloud Shell

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

./install.sh

Google Cloud Shell

When the installation is finished, refresh the Config Connector page on System Settings and you'll see the Config Connector was successfully installed.

Config Connector 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.

Configure the Dashboard admin user

The admin users are the only ones that can:

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

See Also

Create Dashboard credentials

Step by step instructions on how to setup your credentials that will allow you to login into the [...]

Install the Presslabs Dashboard

The Presslabs dashboard can be installed with a simple click from Google's Marketplace, after making [...]

Presslabs Dashboard Prerequisites

Before installing the Presslabs Dashboard from Google Cloud's Marketplace, there are some [...]

Upgrade the Presslabs Dashboard

If you have already installed the Presslabs Dashboard and you want to use a newer version, here is [...]