2021-06-16 21:08:58 +00:00
---
title: Wekan
---
2022-06-15 19:31:34 +00:00
<span class="badge badge--secondary">Support level: Community</span>
2021-06-16 21:08:58 +00:00
## What is Wekan
2023-07-31 10:16:58 +00:00
> Wekan is an open-source kanban board which allows a card-based task and to-do management.
>
> -- https://github.com/wekan/wekan/wiki
2021-06-16 21:08:58 +00:00
## Preparation
The following placeholders will be used:
2022-05-09 19:22:41 +00:00
- `wekan.company` is the FQDN of the wekan install.
- `authentik.company` is the FQDN of the authentik install.
2021-06-16 21:08:58 +00:00
Create an application in authentik. Create an OAuth2/OpenID provider with the following parameters:
2022-05-09 19:22:41 +00:00
- Client Type: `Confidential`
- Scopes: OpenID, Email and Profile
- Signing Key: Select any available key
- Redirect URIs: `https://wekan.company/_oauth/oidc`
2021-06-16 21:08:58 +00:00
Note the Client ID and Client Secret values. Create an application, using the provider you've created above. Note the slug of the application you've created.
## Wekan
2022-05-09 19:22:41 +00:00
import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
2021-06-16 21:08:58 +00:00
<Tabs
defaultValue="docker"
values={[
{label: 'Docker', value: 'docker'},
{label: 'Standalone', value: 'standalone'},
]}>
<TabItem value="docker">
2021-10-18 14:35:12 +00:00
If your Wekan is running in docker, add the following environment variables for authentik
2021-06-16 21:08:58 +00:00
```yaml
2022-05-09 19:22:41 +00:00
environment: OAUTH2_ENABLED=true
OAUTH2_LOGIN_STYLE=redirect
OAUTH2_CLIENT_ID=<Client ID from above>
OAUTH2_SERVER_URL=https://authentik.company
OAUTH2_AUTH_ENDPOINT=/application/o/authorize/
OAUTH2_USERINFO_ENDPOINT=/application/o/userinfo/
OAUTH2_TOKEN_ENDPOINT=/application/o/token/
OAUTH2_SECRET=<Client Secret from above>
OAUTH2_ID_MAP=preferred_username
OAUTH2_USERNAME_MAP=preferred_username
OAUTH2_FULLNAME_MAP=given_name
OAUTH2_EMAIL_MAP=email
2021-06-16 21:08:58 +00:00
```
2022-05-09 19:22:41 +00:00
2021-06-16 21:08:58 +00:00
</TabItem>
<TabItem value="standalone">
2021-10-18 14:35:12 +00:00
2021-06-16 21:08:58 +00:00
edit `.env` and add the following:
```ini
2021-10-18 14:35:12 +00:00
# authentik OAUTH Config
2021-06-16 21:08:58 +00:00
OAUTH2_ENABLED='true'
OAUTH2_LOGIN_STYLE='redirect'
OAUTH2_CLIENT_ID='<Client ID from above>'
OAUTH2_SERVER_URL='https://authentik.company'
OAUTH2_AUTH_ENDPOINT='/application/o/authorize/'
OAUTH2_USERINFO_ENDPOINT='/application/o/userinfo/'
OAUTH2_TOKEN_ENDPOINT='/application/o/token/'
OAUTH2_SECRET='<Client Secret from above>'
OAUTH2_ID_MAP='preferred_username'
OAUTH2_USERNAME_MAP='preferred_username'
OAUTH2_FULLNAME_MAP='given_name'
OAUTH2_EMAIL_MAP='email'
```
2022-05-09 19:22:41 +00:00
2021-06-16 21:08:58 +00:00
</TabItem>
</Tabs>