Skip to content

docker_tasks

docker_post_install_linux()

Show Docker post-install instructions for Linux (run without sudo).

Source code in src/personal_os_setup/tasks/system/docker_tasks.py 
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
def docker_post_install_linux() -> TaskResult:
    """Show Docker post-install instructions for Linux (run without sudo)."""
    return TaskResult(
        ok=True,
        summary="Docker post-install: add user to docker group",
        details=(
            "By default, Docker requires sudo to run.\n"
            "To allow your user (and any tools/scripts) to use Docker without sudo:\n\n"
            "1) Create the docker group (usually already exists):\n"
            "   sudo groupadd docker\n\n"
            "2) Add your user to the group:\n"
            "   sudo usermod -aG docker $USER\n\n"
            "3) Activate the change in the current shell:\n"
            "   newgrp docker\n\n"
            "Pro Tip: newgrp docker only applies to the current terminal window.\n"
            "For a permanent, system-wide effect, log out of your SSH session and log back in.\n\n"
            "On Arch/CachyOS the docker service is not enabled automatically, so also run:\n"
            "   sudo systemctl enable --now docker.service"
        ),
    )