2020-06-18 16:21:15 +00:00
|
|
|
# keycloak
|
|
|
|
|
2020-11-01 16:13:39 +00:00
|
|
|
[![Build Status](https://drone.autonomic.zone/api/badges/coop-cloud/keycloak/status.svg)](https://drone.autonomic.zone/coop-cloud/keycloak)
|
2020-09-29 23:58:35 +00:00
|
|
|
|
2021-03-02 16:38:35 +00:00
|
|
|
[Keycloak](https://www.keycloak.org) + Coöp Cloud.
|
|
|
|
|
|
|
|
<!-- metadata -->
|
|
|
|
* **Category**: Apps
|
2021-11-23 10:19:05 +00:00
|
|
|
* **Status**: 2, beta
|
|
|
|
* **Image**: [`jboss/keycloak`](https://hub.docker.com/r/jboss/keycloak), 4, upstream
|
2021-03-02 16:38:35 +00:00
|
|
|
* **Healthcheck**: Yes
|
|
|
|
* **Backups**: ?
|
2021-11-23 10:19:05 +00:00
|
|
|
* **Email**: 1
|
|
|
|
* **Tests**: 2
|
2021-03-02 16:38:35 +00:00
|
|
|
* **SSO**: N/A
|
|
|
|
<!-- endmetadata -->
|
|
|
|
|
|
|
|
## Basic usage
|
|
|
|
|
|
|
|
1. Set up Docker Swarm and [`abra`][abra]
|
|
|
|
2. Deploy [`coop-cloud/traefik`][cc-traefik]
|
|
|
|
3. `abra app new keycloak --secrets` (optionally with `--pass` if you'd like
|
|
|
|
to save secrets in `pass`)
|
|
|
|
4. `abra app YOURAPPDOMAIN config` - be sure to change `$DOMAIN` to something that resolves to
|
|
|
|
your Docker swarm box
|
|
|
|
5. `abra app YOURAPPDOMAIN deploy`
|
|
|
|
|
2021-10-30 15:26:43 +00:00
|
|
|
## How do I setup a custom theme?
|
|
|
|
|
|
|
|
Check [this approach](https://git.autonomic.zone/ruangrupa/login.lumbung.space).
|
|
|
|
|
|
|
|
## How do I create another admin user?
|
|
|
|
|
|
|
|
- Under the `Master` realm > `Users` > `Add user`
|
|
|
|
- Create the user and set a temporary password
|
|
|
|
- Under the `Role Mappings` tab, move `admin` from `Available Roles` into `Assigned Roles`
|
|
|
|
|
|
|
|
## How do I configure Keycloak login for..
|
|
|
|
|
|
|
|
- [Nextcloud][nextcloud]
|
|
|
|
- [Peertube][peertube]
|
|
|
|
|
|
|
|
[nextcloud]: https://git.coopcloud.tech/coop-cloud/nextcloud
|
|
|
|
[peertube]: https://git.coopcloud.tech/coop-cloud/peertube
|
2021-03-02 16:38:35 +00:00
|
|
|
[abra]: https://git.autonomic.zone/autonomic-cooperative/abra
|
2021-03-02 18:07:56 +00:00
|
|
|
[cc-traefik]: https://git.autonomic.zone/coop-cloud/traefik
|