Install Lagoon Core#
Install the Helm chart#
- Add Lagoon Charts repository to your Helm Repos:
helm repo add lagoon https://uselagoon.github.io/lagoon-charts/
- 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. - 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 - Now run
helm upgrade --install
command, pointing tovalues.yml
, like so:helm upgrade --install --create-namespace --namespace lagoon-core -f values.yml lagoon-core lagoon/lagoon-core`
- Lagoon Core is now installed! :tada:
Warning:
Note: 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.
- Click Administration Console
- Username:
admin
- Password: use
lagoon-core-keycloak
secret, key-valueKEYCLOAK_ADMIN_PASSWORD
- Retrieve the secret like so:`
kubectl -n lagoon-core get secret lagoon-core-keycloak -o jsonpath="{.data.KEYCLOAK_ADMIN_PASSWORD}" | base64 --decode
- Click on User on top right.
- Go to Manage Account.
- Add an Email for the admin account you created.
- Save.
- Go to Realm Lagoon -> Realm Settings -> Email
- Configure email server for Keycloak, test connection via “Test connection” button.
- Go to Realm Lagoon -> Realm Settings -> Login
- Enable “Forgot Password”
- 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.
- Username:
lagoonadmin
- Secret: use
lagoon-core-keycloak
secret key-value:LAGOON-CORE-KEYCLOAK
- Retrieve the secret:
kubectl -n lagoon-core get secret lagoon-core-keycloak -o jsonpath="{.data.KEYCLOAK_LAGOON_ADMIN_PASSWORD}" | base64 --decode