Install Lagoon Core#
Install the Helm chart#
-
Add Lagoon Charts repository to your Helm Repositories:
Add Lagoon Charts repositoryhelm 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 fromapi.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:Upgrade Helm with values.ymlhelm upgrade --install --create-namespace --namespace lagoon-core -f values.yml lagoon-core lagoon/lagoon-core`
-
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.
- Click "Administration Console"
- Username:
admin
- Password: use
lagoon-core-keycloak
secret, key-valueKEYCLOAK_ADMIN_PASSWORD
-
Retrieve the secret like so:
Retrieve secretkubectl -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:
Retrieve secretkubectl -n lagoon-core get secret lagoon-core-keycloak -o jsonpath="{.data.KEYCLOAK_LAGOON_ADMIN_PASSWORD}" | base64 --decode