saeraphinx/authentik-discord-sync
1
0
Fork 0
mirror of https://github.com/Saeraphinx/authentik-discord-sync.git synced 2026-08-07 06:29:25 -05:00
Code Issues Packages Wiki Activity Actions
A simple bot to handle the syncing of discord roles to authentik groups.
4 commits 1 branch 0 tags 104 KiB
  • TypeScript 95.7%
  • Dockerfile 4.3%
Find a file
Exact
Saera f9bb5e3ae6
 add signing permission
2026-01-14 08:24:12 -06:00
.github/workflows add signing permission 2026-01-14 08:24:12 -06:00
.vscode first commit 2025-12-04 16:13:10 -06:00
src update readme & sync messages 2025-12-05 08:22:21 -06:00
.gitignore first commit 2025-12-04 16:13:10 -06:00
Dockerfile first commit 2025-12-04 16:13:10 -06:00
package.json first commit 2025-12-04 16:13:10 -06:00
README.md update readme & sync messages 2025-12-05 08:22:21 -06:00
tsconfig.json first commit 2025-12-04 16:13:10 -06:00
yarn.lock first commit 2025-12-04 16:13:10 -06:00

README.md

authentik-discord-sync

A simple bot to handle the syncing of discord roles to authentik groups. Also allows for manual syncing of users via slash commands.

Setup

Using Docker Compose

Create a docker-compose.yml file with the following content:

version: "3.8"

services:
  discord-sync:
    image: ghcr.io/saeraphinx/authentik-discord-sync:latest
    container_name: authentik-discord-sync
    restart: unless-stopped
    environment:
      - DISCORD_BOT_TOKEN: your-discord-bot-token
      - DISCORD_GUILD_ID: your-discord-guild-id
      - AUTHENTIK_URL: https://authentik.company/api/v3
      - AUTHENTIK_API_KEY: your-authentik-api-key
      - AUTHENTIK_USER_PATH: goauthentik.io/sources/discord-oa

Environment Variables

Example .env file

DISCORD_BOT_TOKEN=your-discord-bot-token
DISCORD_GUILD_ID=your-discord-guild-id
AUTHENTIK_URL=https://authentik.company/api/v3
AUTHENTIK_API_KEY=your-authentik-api-key
AUTHENTIK_USER_PATH=goauthentik.io/sources/discord-oa

Configuration Options

Variable Name (Required) Description Default
DISCORD_BOT_TOKEN Token of your Discord Bot
DISCORD_GUILD_ID ID of the Discord Server that you want to sync roles with
AUTHENTIK_URL URL of your Authentik instance
AUTHENTIK_API_KEY API key of a service account with the ability to edits users & groups
AUTHENTIK_USER_PATH Path of users that you want to automatically sync are located under goauthentik.io/sources/discord-oa