Install Lagoon Core#
Install the Helm chart#
-
Add the Lagoon Charts repository to your Helm repositories:
-
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 a file named
values.yml
in this directory. In this file you declare how you would like Lagoon to be configured. There are mandatory settings and optional ones. A helpful example can be found here. Some hints:- Update the endpoint URLs (such as
lagoonAPIURL
,keycloakFrontEndURL
, andlagoonUIURL
) from placeholders (e.gapi.example.com
) to your particular endpoints. - Optionally, an initial user ("seed user") and/or organization ("seed organization") can be created automatically on install by setting
lagoonSeedUsername
,lagoonSeedPassword
, andlagoonSeedOrganization
as appropriate. For example:
- Update the endpoint URLs (such as
-
Now run
helm upgrade --install
command, pointing tovalues.yml
, like so: -
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:
-
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 via lagoonUIURL
in your values.yml
.
If you configured a seed user in the above steps, you can use it's credentials to log in.
For example, if you set
