34 lines
1.1 KiB
Markdown
34 lines
1.1 KiB
Markdown
# [OCIS](https://github.com/owncloud/ocis/)
|
|
|
|
<!-- metadata -->
|
|
* **Category**: Development
|
|
* **Status**: 1, alpha
|
|
* **Image**: [`owncloud/ocis`](https://hub.docker.com/r/owncloud/ocis), 2, upstream
|
|
* **Healthcheck**: No
|
|
* **Backups**: Yes
|
|
* **Email**: ?
|
|
* **Tests**: 2
|
|
* **SSO**: 3 (OIDC)
|
|
<!-- endmetadata -->
|
|
|
|
## Basic usage
|
|
|
|
1. Set up Docker Swarm and [`abra`][abra]
|
|
2. Deploy [`coop-cloud/traefik`][cc-traefik]
|
|
3. `abra app new ocis --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`
|
|
|
|
## SSO usage
|
|
|
|
By default OCIS includes a built-in Identity Provider. You can use another OpenID Connect provider, too. Keycloak works: Create a new Client, set it to Public mode (not Confidential) and set the `OCIS_OIDC_ISSUER` and `WEB_OIDC_CLIENT_ID` config variables.
|
|
|
|
## App commands
|
|
|
|
### `ocis`
|
|
|
|
To run the `ocis` command-line utility you can use the abra command `ocis`. Use it like this:
|
|
`abra app cmd YOURAPPDOMAIN app ocis`
|