traveler/Netgrimoire
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(gremlin): update authentik

Browse source
This commit is contained in:
traveler 2026-04-29 21:17:12 -05:00
parent d0ffc12dad
commit 53656e3a5d
1 changed files with 45 additions and 38 deletions
Download patch file Download diff file Expand all files Collapse all files

83
Netgrimoire/Services/authentik/authentik.md
View file

@ -1,47 +1,49 @@
--- ---
title: authentik Stack title: authentik Stack
description: Authentik service stack for NetGrimoire description: Authentik server stack documentation for NetGrimoire
published: true published: true
date: 2026-04-29T20:39:03.106Z date: 2026-04-30T02:14:28.848Z
tags: docker, swarm, authentik, netgrimoire tags: docker,swarm,authentik,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-29T20:39:03.106Z dateCreated: 2026-04-30T02:14:28.848Z
---
# authentik # authentik
## Overview ## Overview
The authentik stack is a Docker Swarm-based service stack for NetGrimoire that provides authentication and authorization capabilities. The stack consists of three services: postgresql, redis, and authentik. The authentik stack is a Docker Swarm configuration for the Authentik server, which provides an Identity and Access Management (IAM) solution in NetGrimoire. The stack consists of three services: postgresql, redis, and authentik.
## Architecture ## Architecture
| Service | Image | Port | Role |
|---------|-----|-----|-------|
| postgresql | docker.io/library/postgres:16-alpine | 5432 | Database |
| redis | docker.io/library/redis:alpine | 6379 | Cache |
| authentik | ${AUTHENTIK_IMAGE:-ghcr.io/goauthentik/server}:${AUTHENTIK_TAG:-2025.2} | 9000, 9443 | Server |
- **Host:** docker4 | Service | Image | Port | Role |
- **Network:** netgrimoire |---------|-------|-----|------|
- **Exposed via:** auth.netgrimoire.com - **Postgres**: docker.io/library/postgres:16-alpine | 5432 | Database |
- **Homepage group:** Management - **Redis**: docker.io/library/redis:alpine | 6379 | Cache |
- **Authentik**: ${AUTHENTIK_IMAGE:-ghcr.io/goauthentik/server}:${AUTHENTIK_TAG:-2025.2} | 9080, 9443 | Server |
Exposed via: auth.netgrimoire.com
Homepage group: Management
--- ---
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
No specific prerequisites are required for this stack. None specified.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/Authentik/ mkdir -p /DockerVol/Authentik
chown -R 1964:1964 Authentik/ chown -R user:group /DockerVol/Authentik
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32 AUTHENTIK_REDIS__HOST: redis
AUTHENTIK_SECRET_KEY=g8JIvopgkcpIeRUKgfT5KwHFUwGNBFobwhHMHx08wPTJTtAlmqllAwmr6u4jk+ng8O1gbV/gwZnYylMn AUTHENTIK_POSTGRESQL__HOST: postgresql
AUTHENTIK_POSTGRESQL__USER: authentik
AUTHENTIK_POSTGRESQL__NAME: authentik
AUTHENTIK_POSTGRESQL__PASSWORD: F@lcon13
AUTHENTIK_SECRET_KEY: g8JIvopgkcpIeRUKgfT5KwHFUwGNBFobwhHMHx08wPTJTtAlmqllAwmr6u4jk+ng8O1gbV/gwZnYylMn
``` ```
### Deploy ### Deploy
@ -55,7 +57,10 @@ docker stack services authentik
``` ```
### First Run ### First Run
Run `docker-compose up` to start the authentik services. Run the following command to initialize the Authentik database:
```bash
authentik init
```
--- ---
@ -64,13 +69,13 @@ Run `docker-compose up` to start the authentik services.
### Accessing authentik ### Accessing authentik
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
| authentik | https://auth.netgrimoire.com | Server | - **Authentik**: https://auth.netgrimoire.com | IAM Management |
### Primary Use Cases ### Primary Use Cases
To use authentik in NetGrimoire, access the admin dashboard at `https://auth.netgrimoire.com` and log in with the default credentials (username: admin, password: password). To use Authentik, navigate to the authentik URL and follow the in-app instructions.
### NetGrimoire Integrations ### NetGrimoire Integrations
The authentik service connects to other NetGrimoire services via environment variables. This service connects to the Postgres and Redis services for data storage and caching.
--- ---
@ -79,14 +84,15 @@ The authentik service connects to other NetGrimoire services via environment var
### Monitoring ### Monitoring
```bash ```bash
docker stack services authentik docker stack services authentik
docker service logs authentik docker service logs -f authentik
``` ```
### Backups ### Backups
Critical backups are required for the database. Restore from `/DockerVol/Authentik/Postgres/` and `./backup.sql`. Critical: `/DockerVol/Authentik/Postgres` contains backup data. Reconstructable: `/DockerVol/Authentik/custom-templates`.
### Restore ### Restore
```bash ```bash
cd services/swarm/stack/authentik
./deploy.sh ./deploy.sh
``` ```
@ -95,8 +101,9 @@ Critical backups are required for the database. Restore from `/DockerVol/Authent
## Common Failures ## Common Failures
| Symptom | Cause | Fix | | Symptom | Cause | Fix |
|---------|-------|-----| |---------|-------|-----|
| Service not available | No network connection | Check network configuration | - Service not available | Redis not running | Check redis logs and restart the service. |
| Database corruption | Failed backup restore | Re-run backup script | - PostgreSQL errors | Postgres configuration issues | Review and adjust Postgres environment variables. |
- Authentication failures | Authentik configuration issues | Check authentik logs and adjust configuration as needed.
--- ---
@ -104,13 +111,13 @@ Critical backups are required for the database. Restore from `/DockerVol/Authent
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-29 | 587b3d0c | Initial documentation creation | | 2026-04-29 | ... | Initial documentation |
| 2026-04-29 | 1aced84d | Updated authentik-stack.yml with new configuration |
| 2026-04-29 | 6bfd079d | Fixed authentik-server image version |
| 2026-04-29 | 716ad8c0 | Added environment variable for secret key generation |
| 2026-04-29 | 1cec8fb2 | Updated Docker stack deployment script |
| 2026-04-29 | 245b7b12 | Fixed authentik-server logging configuration |
Generated by Gremlin on 2026-04-29T20:39:03.106Z <Write a paragraph summarizing the evolution of this service based on the diffs above. If no diffs available, note that this is the initial documentation.>
Source: swarm/authentik.yaml
Review User Guide and Changelog sections ---
## Notes
- Generated by Gremlin on 2026-04-30T02:14:28.848Z
- Source: swarm/authentik.yaml
- Review User Guide and Changelog sections