The badge displayed on my repository indicates the status of the deployment verification workflow as executed on the latest commit to the main branch.
Passing: This means the most recent commit has successfully passed all deployment checks, confirming that the Docker Compose setup functions correctly as designed.
📙 The complete installation guide is available on my website.
❗ Change variables in the .env
to meet your requirements.
💡 Note that the .env
file should be in the same directory as 01-traefik-outline-letsencrypt-docker-compose.yml
, 02-keycloak-outline-docker-compose.yml
, and 03-outline-minio-redis-docker-compose.yml
.
❗ The value for the OUTLINE_OIDC_CLIENT_SECRET
variable can be obtained after installing Keycloak using 02-keycloak-outline-docker-compose.yml
.
❗ Additionally, you need to specify your values for OUTLINE_SECRET_KEY
and OUTLINE_UTILS_SECRET
.
The values for OUTLINE_SECRET_KEY
and OUTLINE_UTILS_SECRET
can be generated using the command:
openssl rand -hex 32
Create networks for your services before deploying the configuration using the commands:
docker network create traefik-network
docker network create keycloak-network
docker network create outline-network
Deploy Traefik using Docker Compose:
docker compose -f 01-traefik-outline-letsencrypt-docker-compose.yml -p traefik up -d
Deploy Keycloak using Docker Compose:
docker compose -f 02-keycloak-outline-docker-compose.yml -p keycloak up -d
Create a new Realm
on Keycloak and name it outline
(case sensitive).
Create a Client
in the new realm and configure it:
- Client type:
OpenID Connect
- Client ID:
outline
(case sensitive) - Client authentication:
on
- Authentication flow: uncheck all other options and leave only
Standard flow
- Set URLs:
- In the
Root URL
field, enterhttps://outline.heyvaldemar.net/
- In the
Home URL
field, enterhttps://outline.heyvaldemar.net/
- In the
Valid redirect URIs
field, enterhttps://outline.heyvaldemar.net/*
💡 Please note, outline.heyvaldemar.net is the domain name of my service. Accordingly, you need to specify your domain name, which points to the IP address of your server with the installed Traefik service, which will redirect the request to Outline.
Get a Client secret
value on the Credentials
tab of the Client
that you created.
Specify the OUTLINE_OIDC_CLIENT_SECRET
variable in the .env
.
Create a user on Keycloak for Outline.
Note that you have to specify an email address and a username.
Set a password for the new user.
Deploy Keycloak using Docker Compose:
docker compose -f 03-outline-minio-redis-docker-compose.yml -p outline up -d
Log in to Outline with the Username or Email specified on the Keycloak.
The backups-keycloak
container in the configuration is responsible for the following:
-
Database Backup: Creates compressed backups of the PostgreSQL database using pg_dump. Customizable backup path, filename pattern, and schedule through variables like
KEYCLOAK_POSTGRES_BACKUPS_PATH
,KEYCLOAK_POSTGRES_BACKUP_NAME
, andKEYCLOAK_BACKUP_INTERVAL
. -
Backup Pruning: Periodically removes backups exceeding a specified age to manage storage. Customizable pruning schedule and age threshold with
KEYCLOAK_POSTGRES_BACKUP_PRUNE_DAYS
.
The backups-outline
container in the configuration is responsible for the following:
-
Application Data Backup: Compresses and stores backups of the application data on the same schedule. Controlled via variables such as
OUTLINE_DATA_BACKUPS_PATH
,OUTLINE_DATA_BACKUP_NAME
, andOUTLINE_BACKUP_INTERVAL
. -
Backup Pruning: Periodically removes backups exceeding a specified age to manage storage. Customizable pruning schedule and age threshold with
OUTLINE_DATA_BACKUP_PRUNE_DAYS
.
By utilizing these containers, consistent and automated backups of the essential components of your instance are ensured. Moreover, efficient management of backup storage and tailored backup routines can be achieved through easy and flexible configuration using environment variables.
This script facilitates the restoration of a database backup:
-
Identify Containers: It first identifies the service and backups containers by name, finding the appropriate container IDs.
-
List Backups: Displays all available database backups located at the specified backup path.
-
Select Backup: Prompts the user to copy and paste the desired backup name from the list to restore the database.
-
Stop Service: Temporarily stops the service to ensure data consistency during restoration.
-
Restore Database: Executes a sequence of commands to drop the current database, create a new one, and restore it from the selected compressed backup file.
-
Start Service: Restarts the service after the restoration is completed.
To make the keycloak-restore-database.shh
script executable, run the following command:
chmod +x keycloak-restore-database.sh
Usage of this script ensures a controlled and guided process to restore the database from an existing backup.
This script facilitates the restoration of a database backup:
-
Identify Containers: It first identifies the service and backups containers by name, finding the appropriate container IDs.
-
List Backups: Displays all available database backups located at the specified backup path.
-
Select Backup: Prompts the user to copy and paste the desired backup name from the list to restore the database.
-
Stop Service: Temporarily stops the service to ensure data consistency during restoration.
-
Restore Database: Executes a sequence of commands to drop the current database, create a new one, and restore it from the selected compressed backup file.
-
Start Service: Restarts the service after the restoration is completed.
To make the outline-restore-database.shh
script executable, run the following command:
chmod +x outline-restore-database.sh
Usage of this script ensures a controlled and guided process to restore the database from an existing backup.
This script is designed to restore the application data:
-
Identify Containers: Similarly to the database restore script, it identifies the service and backups containers by name.
-
List Application Data Backups: Displays all available application data backups at the specified backup path.
-
Select Backup: Asks the user to copy and paste the desired backup name for application data restoration.
-
Stop Service: Stops the service to prevent any conflicts during the restore process.
-
Restore Application Data: Removes the current application data and then extracts the selected backup to the appropriate application data path.
-
Start Service: Restarts the service after the application data has been successfully restored.
To make the outline-restore-application-data.sh
script executable, run the following command:
chmod +x outline-restore-application-data.sh
By utilizing this script, you can efficiently restore application data from an existing backup while ensuring proper coordination with the running service.
I’m Vladimir Mikhalev, the Docker Captain, but my friends can call me Valdemar.
🌐 My website with detailed IT guides
🎬 Follow me on YouTube
🐦 Follow me on Twitter
🎨 Follow me on Instagram
🧵 Follow me on Threads
🐘 Follow me on Mastodon
🧊 Follow me on Bluesky
🎸 Follow me on Facebook
🎥 Follow me on TikTok
💻 Follow me on LinkedIn
🐈 Follow me on GitHub
👾 Chat with IT pros on Discord
📧 Reach me at [email protected]
💎 Support on GitHub
🏆 Support on Patreon
🥤 Support on BuyMeaCoffee
🍪 Support on Ko-fi
💖 Support on PayPal