refactor: extract WSL fix to standalone script and add documentationmain

3 files changed, 87 insertions, 12 deletions

diff --git a/Makefile b/Makefile
index 42dade6..dc3ddb7 100644
--- a/Makefile
+++ b/Makefile
@@ -265,17 +265,7 @@ check-now-system:
 
 # WSL2 fix: ensure /run/user/UID exists for systemd --user
 fix-wsl:
-	@RUNTIME_DIR="/run/user/$(id - u)"; \
-	if [ ! -d "$$RUNTIME_DIR" ]; then \
-		echo "WSL2: Creating missing $$RUNTIME_DIR..."; \
-		sudo mkdir -p "$$RUNTIME_DIR" && \
-		sudo chmod 700 "$$RUNTIME_DIR" && \
-		sudo chown "$(id -un):$(id -gn)" "$$RUNTIME_DIR"; \
-		sudo systemctl start "user@$(id - u).service" 2>/dev/null || true; \
-		export XDG_RUNTIME_DIR="$$RUNTIME_DIR"; \
-		export DBUS_SESSION_BUS_ADDRESS="unix:path=$${RUNTIME_DIR}/bus"; \
-		(sleep 2 && systemctl --user daemon-reexec) 2>/dev/null || true; \
-	fi
+	@./wsl-fix.sh
 
 status: fix-wsl
 	@echo "=== User Timer Status ==="
diff --git a/README.md b/README.md
index ed6b363..c3f5bc0 100644
--- a/README.md
+++ b/README.md
@@ -71,4 +71,13 @@ restic check --repo rclone:backup_remote:/drestic_backups_HOSTNAME --password-fi
 make unlock-repo   # fix locked repository
 make logs         # check recent logs
 rclone ls backup_remote:  # test MEGA connection
-```
\ No newline at end of file
+```
+## WSL Users
+
+Systemd timers don't persist across WSL restarts. After each WSL restart, run:
+
+```bash
+make fix-wsl
+```
+
+This will prompt for sudo once to set up the systemd user session, then you can use all normal commands (`make status`, `make backup-now`, etc.).
diff --git a/wsl-fix.sh b/wsl-fix.sh
new file mode 100755
index 0000000..06e532a
--- /dev/null
+++ b/wsl-fix.sh
@@ -0,0 +1,76 @@
+#!/bin/bash
+set -euo pipefail
+
+# WSL Systemd Fix Script
+# Run this once per WSL restart to enable systemd user sessions
+
+# Detect if running on WSL
+if [[ ! -f /proc/version ]] || ! grep -qi microsoft /proc/version; then
+    echo "Not running on WSL - nothing to do"
+    exit 0
+fi
+
+USER_ID=$(id -u)
+USER_NAME=$(id -un)
+USER_GROUP=$(id -gn)
+RUNTIME_DIR="/run/user/${USER_ID}"
+
+echo "=== WSL Systemd User Session Setup ==="
+echo "User: ${USER_NAME} (UID: ${USER_ID})"
+echo "Runtime directory: ${RUNTIME_DIR}"
+echo ""
+
+# Check if already set up
+if [[ -d "${RUNTIME_DIR}" ]] && [[ -S "${RUNTIME_DIR}/bus" ]]; then
+    echo "Runtime directory already exists and dbus socket is present."
+    echo "Setting environment variables..."
+    export XDG_RUNTIME_DIR="${RUNTIME_DIR}"
+    export DBUS_SESSION_BUS_ADDRESS="unix:path=${RUNTIME_DIR}/bus"
+    echo ""
+    echo "Environment set. You can now use: make status, make backup-now, etc."
+    exit 0
+fi
+
+# Create runtime directory (requires sudo)
+if [[ ! -d "${RUNTIME_DIR}" ]]; then
+    echo "Creating runtime directory (requires sudo)..."
+    sudo mkdir -p "${RUNTIME_DIR}"
+    sudo chmod 700 "${RUNTIME_DIR}"
+    sudo chown "${USER_NAME}:${USER_GROUP}" "${RUNTIME_DIR}"
+    echo "✓ Runtime directory created"
+fi
+
+# Start user systemd service (requires sudo)
+echo "Starting systemd user session (requires sudo)..."
+sudo systemctl start "user@${USER_ID}.service" 2>/dev/null || true
+echo "✓ Systemd user session started"
+
+# Wait a moment for dbus socket to be created
+echo "Waiting for dbus socket..."
+for i in {1..10}; do
+    if [[ -S "${RUNTIME_DIR}/bus" ]]; then
+        break
+    fi
+    sleep 0.5
+done
+
+if [[ ! -S "${RUNTIME_DIR}/bus" ]]; then
+    echo "Warning: dbus socket not found, systemd may not be fully initialized"
+fi
+
+# Set environment variables
+export XDG_RUNTIME_DIR="${RUNTIME_DIR}"
+export DBUS_SESSION_BUS_ADDRESS="unix:path=${RUNTIME_DIR}/bus"
+
+# Reload systemd daemon
+systemctl --user daemon-reexec 2>/dev/null || true
+
+echo ""
+echo "=== Setup Complete ==="
+echo "Environment variables set for current session:"
+echo "  XDG_RUNTIME_DIR=${XDG_RUNTIME_DIR}"
+echo "  DBUS_SESSION_BUS_ADDRESS=${DBUS_SESSION_BUS_ADDRESS}"
+echo ""
+echo "You can now use: make status, make backup-now, make check-now, etc."
+echo ""
+echo "Note: Run 'make fix-wsl' again after each WSL restart."