Merge branch 'master' into 709-merge-master

.github/workflows/admin.yml

@@ -44,29 +44,24 @@ jobs:
     name: Build Docker Production - Admin
     needs: files-changed
     runs-on: ubuntu-latest
-    env:
-      WORKING_DIRECTORY: ./admin
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
       - name: Admin | Build Docker Production
-        run: docker compose -f docker-compose.yml build
+        run: docker compose -f docker-compose.yml build admin
 
   docker-development:
     if: needs.files-changed.outputs.admin == 'true'
     name: Build Docker Development - Admin
     needs: files-changed
     runs-on: ubuntu-latest
-    env:
-      WORKING_DIRECTORY: ./admin
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
       - name: Admin | Build Docker Development
-        run: docker compose build
-        working-directory: ${{env.WORKING_DIRECTORY}}
+        run: docker compose build admin admin-documentation admin-storybook
 
   docs:
     if: needs.files-changed.outputs.admin-docs == 'true'

.github/workflows/backend.yml

@@ -49,30 +49,24 @@ jobs:
     name: Build Docker Production - Backend
     needs: files-changed
     runs-on: ubuntu-latest
-    env:
-      WORKING_DIRECTORY: ./backend
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
       - name: Backend | Build Docker Production
-        run: docker compose -f docker-compose.yml build
-        working-directory: ${{env.WORKING_DIRECTORY}}
+        run: docker compose -f docker-compose.yml build backend
 
   docker-development:
     if: needs.files-changed.outputs.backend == 'true'
     name: Build Docker Development - Backend
     needs: files-changed
     runs-on: ubuntu-latest
-    env:
-      WORKING_DIRECTORY: ./backend
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
       - name: Backend | Build Docker Development
-        run: docker compose build
-        working-directory: ${{env.WORKING_DIRECTORY}}
+        run: docker compose build backend backend-documentation
 
   docs:
     if: needs.files-changed.outputs.backend-docs == 'true'

.github/workflows/frontend..yml

@@ -44,30 +44,24 @@ jobs:
     name: Build Docker Production - Frontend
     needs: files-changed
     runs-on: ubuntu-latest
-    env:
-      WORKING_DIRECTORY: ./frontend
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
       - name: Frontend | Build Docker Production
-        run: docker compose -f docker-compose.yml build
-        working-directory: ${{env.WORKING_DIRECTORY}}
+        run: docker compose -f docker-compose.yml build frontend
 
   docker-development:
     if: needs.files-changed.outputs.frontend == 'true'
     name: Build Docker Development - Frontend
     needs: files-changed
     runs-on: ubuntu-latest
-    env:
-      WORKING_DIRECTORY: ./frontend
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
       - name: Frontend | Build Docker Development
-        run: docker compose build
-        working-directory: ${{env.WORKING_DIRECTORY}}
+        run: docker compose build frontend frontend-documentation frontend-storybook
 
   docs:
     if: needs.files-changed.outputs.frontend-docs == 'true'

.github/workflows/presenter.yml

@@ -44,30 +44,24 @@ jobs:
     name: Build Docker Production - Presenter
     needs: files-changed
     runs-on: ubuntu-latest
-    env:
-      WORKING_DIRECTORY: ./presenter
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
       - name: Presenter | Build Docker Production
-        run: docker compose -f docker-compose.yml build
-        working-directory: ${{env.WORKING_DIRECTORY}}
+        run: docker compose -f docker-compose.yml build presenter
 
   docker-development:
     if: needs.files-changed.outputs.presenter == 'true'
     name: Build Docker Development - Presenter
     needs: files-changed
     runs-on: ubuntu-latest
-    env:
-      WORKING_DIRECTORY: ./presenter
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
       - name: Presenter | Build Docker Development
-        run: docker compose build
-        working-directory: ${{env.WORKING_DIRECTORY}}
+        run: docker compose build presenter presenter-documentation presenter-storybook
 
   docs:
     if: needs.files-changed.outputs.presenter-docs == 'true'

admin/README.md

@@ -67,20 +67,6 @@ This projects utilizes `storybook` and `chromatic` to develop, document & test f
 | **Maintenance**             |                                                  |
 | `npm run update`            | Check for updates                                |
 
-### Docker
-
-### Docker development mode
-
-```bash
-docker compose up
-```
-
-### Docker can be run in production mode
-
-```bash
-docker compose -f docker-compose.yml up
-```
-
 ### Chromatic
 
 In order to use the chromatic workflow you need to provide a `CHROMATIC_PROJECT_TOKEN` in the repository secrets.

authentik/README.md

@@ -48,3 +48,26 @@ If you want to publish changes to the database you can use the following command
 
 (Note: this assumes you are not root and sets the permissions of the database files via sudo)
 (Note: make sure to shut down the database first before you run the script)
+
+## E-Mail testing
+
+Authentik e-mails can be checked locally via [Mailpit mailserver](https://mailpit.axllent.org/).
+
+### Prepare and start
+
+In the `authentik/` directory start authentik and mailserver:
+
+```bash
+docker-compose -f docker-compose.yml -f docker-compose.test.yml up
+```
+
+### Example
+
+The given setup can be tested via [Authentik's e-mail testing tool](https://github.com/goauthentik/authentik/blob/main/authentik/stages/email/management/commands/test_email.py)
+
+Send a test email with:
+```bash
+docker compose exec worker ak test_email [email protected]
+```
+
+Visit [Mailpit](http://localhost:8025) and see your test email.

authentik/docker-compose.test.yml

@@ -0,0 +1,22 @@
+x-mail-settings: &x-mail-settings
+  environment:
+    - AUTHENTIK_EMAIL__HOST=mailserver
+    - AUTHENTIK_EMAIL__PORT=1025
+    - AUTHENTIK_EMAIL__USE_TLS=false
+    - AUTHENTIK_EMAIL__USE_SSL=false
+    - AUTHENTIK_EMAIL__TIMEOUT=10
+    - [email protected]
+
+services:
+  mailserver:
+    image: axllent/mailpit
+    container_name: mailpit
+    restart: unless-stopped
+    ports:
+      - 8025:8025
+      - 1025:1025
+
+  server:
+    <<: *x-mail-settings
+  worker:
+    <<: *x-mail-settings

authentik/docker-compose.yml

@@ -1,5 +1,3 @@
-version: "3.4"
-
 services:
   postgresql:
     image: docker.io/library/postgres:12-alpine

backend/README.md

@@ -48,18 +48,6 @@ The following commands are available:
 | **Maintenance**            |                                                 |
 | `npm run update`           | Check for updates                               |
 
-### Docker
-
-Docker can be run in development mode utilizing `docker-compose.overwrite.yml`:
-```bash
-docker compose up
-```
-
-Docker can be run in production mode:
-```bash
-docker compose -f docker-compose.yml up
-```
-
 ### Update
 
 You can get a list of packes to update by running `npm run update`.