silvarion.containers

Ansible collection providing standardized container-platform roles for Linux:

• docker — Docker Engine, the Compose plugin, and Buildx from the official Docker vendor repository. Foundation role for every other role in this collection.
• dockge — Dockge, a reactive, self-hosted Docker Compose stack manager UI.
• komodo — Komodo, a build-and-deploy platform for servers and containers (Core + Periphery + MongoDB/FerretDB).
• podman — Podman, a daemonless, OCI-compliant container engine, from OS vendor packages. Standalone alternative to docker.

Requirements

• Ansible >= 2.14
• Collections: community.docker, ansible.posix
• Supported platforms: Ubuntu 24.04, Rocky Linux 9 (see each role's README.md for details)

Installation

ansible-galaxy collection install silvarion.containers

Usage

- hosts: container_hosts
  become: true
  roles:
    - role: silvarion.containers.docker

    - role: silvarion.containers.dockge
      vars:
        dockge_stacks:
          - name: uptime-kuma
            repo: https://example.com/org/uptime-kuma-stack.git
            version: main
            compose_file: compose.yaml

    - role: silvarion.containers.komodo
      vars:
        komodo_core_config_host: "https://komodo.example.com"
        komodo_core_secrets_admin_password: "{{ lookup('community.hashi_vault.hashi_vault', 'secret/komodo:admin_password') }}"

    - role: silvarion.containers.podman
      vars:
        podman_rootless_users:
          - deploy

Or run one of the ready-made collection playbooks:

ansible-playbook silvarion.containers.docker  -i inventory
ansible-playbook silvarion.containers.dockge  -i inventory
ansible-playbook silvarion.containers.komodo  -i inventory
ansible-playbook silvarion.containers.podman  -i inventory

Roles

Role	Description	Docs
docker	Docker Engine, Compose plugin, Buildx, docker group management	roles/docker/README.md
dockge	Dockge stack-manager UI + git-sourced Compose stacks	roles/dockge/README.md
komodo	Komodo Core/Periphery + git-sourced Compose stacks	roles/komodo/README.md
podman	Podman + netavark/aardvark-dns, rootless user provisioning	roles/podman/README.md

Contributing conventions

See AGENT.md for role layout, tag taxonomy, variable naming, and the git-repo-sourced "stacks" pattern shared by dockge and komodo.

Support

Feel free to create issues on the project or contact me.

Authors and acknowledgment

Author: Jesus Alejandro Sanchez Davila

Maintainer: Jesus Alejandro Sanchez Davila

Email: jsanchez.consultant@gmail.com