From 259a89c6fa024abd752ae7ce99f91a13a005697b Mon Sep 17 00:00:00 2001 From: Ryan Slominski Date: Fri, 12 Jan 2024 10:00:18 -0500 Subject: [PATCH 1/2] Add Windows Instructions Fixes #578 --- README | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/README b/README index c6e494aa..22ee21ce 100644 --- a/README +++ b/README @@ -188,6 +188,35 @@ to upgrade the configuration and data. Of course, keeping backup of the data directory for cases when the upgrade process fails is recommended. +## Running on Windows with Docker Compose +The freeipa server requires systemd inside the container. By default on Windows Subsystem for Linux (WSL) systemd is disabled and [must be enabled](https://learn.microsoft.com/en-us/windows/wsl/wsl-config#systemd-support): + +Step 1: Stop Docker Desktop. +Step 2: Configure WSL distro and shut it down: +``` +C:\Users\john>bash +john@COMPUTER:/mnt/c/Users/john$ echo -e "[boot]\nsystemd=true" | sudo tee -a /etc/wsl.conf > /dev/null +john@COMPUTER:/mnt/c/Users/john$ exit +wsl --shutdown +``` +Step 3: Start Docker Desktop +Step 4: Run `docker compose up` +where __docker-compose.yml__ is: +``` +services: + ipa: + image: freeipa/freeipa-server:rocky-9-4.10.2 + hostname: ipa.example.com + container_name: ipa + sysctls: + - net.ipv6.conf.all.disable_ipv6=0 + environment: + IPA_SERVER_INSTALL_OPTS: '-r EXAMPLE.COM -N -U' + PASSWORD: password + volumes: + - /sys/fs/cgroup:/sys/fs/cgroup:ro +``` + ## Backup and restore Speaking of backups: the FreeIPA server container stores all From 3ced71dc36035a87645768fca27b1da9cdca4b82 Mon Sep 17 00:00:00 2001 From: Ryan Slominski Date: Fri, 12 Jan 2024 10:23:10 -0500 Subject: [PATCH 2/2] Add spaces Keep each step on new line. --- README | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README b/README index 22ee21ce..edad2c58 100644 --- a/README +++ b/README @@ -191,16 +191,16 @@ is recommended. ## Running on Windows with Docker Compose The freeipa server requires systemd inside the container. By default on Windows Subsystem for Linux (WSL) systemd is disabled and [must be enabled](https://learn.microsoft.com/en-us/windows/wsl/wsl-config#systemd-support): -Step 1: Stop Docker Desktop. -Step 2: Configure WSL distro and shut it down: +Step 1: Stop Docker Desktop. +Step 2: Configure WSL distro and shut it down: ``` C:\Users\john>bash john@COMPUTER:/mnt/c/Users/john$ echo -e "[boot]\nsystemd=true" | sudo tee -a /etc/wsl.conf > /dev/null john@COMPUTER:/mnt/c/Users/john$ exit wsl --shutdown ``` -Step 3: Start Docker Desktop -Step 4: Run `docker compose up` +Step 3: Start Docker Desktop +Step 4: Run `docker compose up` where __docker-compose.yml__ is: ``` services: