Skip to content

Install Lagoon Core#

Install the Helm chart#

  1. Add Lagoon Charts repository to your Helm Repositories:

    Add Lagoon Charts repository
    helm repo add lagoon https://uselagoon.github.io/lagoon-charts/

  2. Create a directory for the configuration files we will create, and make sure that it’s version controlled. Ensure that you reference this path in commands referencing your values.yml files.

  3. Create values.yml in the directory you’ve just created. Update the endpoint URLs (change them from api.lagoon.example.com to your values). Example: https://github.com/uselagoon/lagoon-charts/blob/main/charts/lagoon-core/ci/linter-values.yaml

  4. Now run helm upgrade --install command, pointing to values.yml, like so:

    Upgrade Helm with values.yml
    helm upgrade --install --create-namespace --namespace lagoon-core -f values.yml lagoon-core lagoon/lagoon-core`

  5. Lagoon Core is now installed!

Warning

Sometimes we run into Docker Hub pull limits. We are considering moving our images elsewhere if this continues to be a problem.

Configure Keycloak#

Visit the Keycloak dashboard at the URL you defined in the values.yml for Keycloak.

  1. Click "Administration Console"
  2. Username: admin
  3. Password: use lagoon-core-keycloak secret, key-value KEYCLOAK_ADMIN_PASSWORD

  4. Retrieve the secret like so:

    Retrieve secret
    kubectl -n lagoon-core get secret lagoon-core-keycloak -o jsonpath="{.data.KEYCLOAK_ADMIN_PASSWORD}" | base64 --decode

  5. Click on User on top right.

    1. Go to Manage Account.
    2. Add an Email for the admin account you created.
    3. Save.
  6. Go to Realm Lagoon -> Realm Settings -> Email
    1. Configure email server for Keycloak, test connection via “Test connection” button.
  7. Go to Realm Lagoon -> Realm Settings -> Login
    1. Enable “Forgot Password”
    2. Save.

Log in to the UI#

You should now be able to visit the Lagoon UI at the URL you defined in the values.yml for the UI.

  1. Username: lagoonadmin
  2. Secret: use lagoon-core-keycloak secret key-value: LAGOON-CORE-KEYCLOAK
  3. Retrieve the secret:
    Retrieve secret
        kubectl -n lagoon-core get secret lagoon-core-keycloak -o jsonpath="{.data.KEYCLOAK_LAGOON_ADMIN_PASSWORD}" | base64 --decode