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 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/
orhttps://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/
orhttps://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
See Also
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 [...]
Setup Authentication
Step by step instructions on how to setup your credentials that will allow you to login into the [...]
Upgrade the Presslabs Dashboard
If you have already installed the Presslabs Dashboard and you want to use a newer version, here is [...]