forked from coop-cloud/keycloak
47 lines
1.5 KiB
Markdown
47 lines
1.5 KiB
Markdown
# keycloak
|
|
|
|
[![Build Status](https://drone.autonomic.zone/api/badges/coop-cloud/keycloak/status.svg)](https://drone.autonomic.zone/coop-cloud/keycloak)
|
|
|
|
[Keycloak](https://www.keycloak.org) + Coöp Cloud.
|
|
|
|
<!-- metadata -->
|
|
* **Category**: Apps
|
|
* **Status**: 2, beta
|
|
* **Image**: [`jboss/keycloak`](https://hub.docker.com/r/jboss/keycloak), 4, upstream
|
|
* **Healthcheck**: Yes
|
|
* **Backups**: ?
|
|
* **Email**: 1
|
|
* **Tests**: 2
|
|
* **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`
|
|
|
|
## 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
|
|
[abra]: https://git.autonomic.zone/autonomic-cooperative/abra
|
|
[cc-traefik]: https://git.autonomic.zone/coop-cloud/traefik
|