Gestionnaires de paquets et binaires

Utilisez cette page pour les installations sans conteneur et les téléchargements manuels de binaires.

Outils d’exécution

Les images de conteneur incluent déjà ces outils. Les installations sans conteneur doivent les fournir sur l’hôte.

Rôle hôte	Outils requis
Contrôleur	Certificats CA, `git`.
Agent	`git`, Docker CLI, plugin Docker Buildx, plugin Docker Compose, accès au démon Docker.

Les paquets et archives Linux installent les binaires Composia et des unités systemd facultatives. Ils n’installent pas Docker, Docker Compose ou Git pour vous.

Debian et Ubuntu

Ajoutez le dépôt APT Forgejo :

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl https://forgejo.alexma.top/api/packages/alexma233/debian/repository.key \
  -o /etc/apt/keyrings/composia.asc

echo "deb [signed-by=/etc/apt/keyrings/composia.asc] https://forgejo.alexma.top/api/packages/alexma233/debian stable main" \
  | sudo tee /etc/apt/sources.list.d/composia.list

sudo apt update
sudo apt install composia

Vous pouvez également télécharger le paquet .deb depuis la page des Releases et l’installer avec votre gestionnaire de paquets.

Vérifiez :

composia --version

Fedora, RHEL et distributions compatibles

Utilisez COPR sur Fedora :

sudo dnf copr enable alexma233/composia
sudo dnf install composia

Vous pouvez également télécharger le paquet .rpm depuis la page des Releases et l’installer avec dnf ou yum.

Vérifiez :

composia --version

Arch Linux

Deux paquets AUR sont publiés :

Paquet	Source
`composia-bin`	Binaires de release précompilés.
`composia`	Compilé depuis les sources.

Installez l’un d’eux avec votre helper AUR :

paru -S composia-bin

ou :

paru -S composia

Les deux paquets sont en conflit l’un avec l’autre. N’en installez qu’un seul.

Vous pouvez également télécharger le paquet .pkg.tar.zst depuis la page des Releases et l’installer avec pacman -U.

Vérifiez :

composia --version

Nix Flake

Installez depuis le flake du dépôt :

nix profile install git+https://forgejo.alexma.top/alexma233/composia

Exécutez un binaire directement :

nix run git+https://forgejo.alexma.top/alexma233/composia#composia
nix run git+https://forgejo.alexma.top/alexma233/composia#composia-controller
nix run git+https://forgejo.alexma.top/alexma233/composia#composia-agent

Systèmes flake pris en charge : x86_64-linux, aarch64-linux, i686-linux, armv7l-linux, riscv64-linux.

Le paquet nixpkgs n’est pas encore fusionné. Suivez la PR upstream sur NixOS/nixpkgs#515061. En attendant, utilisez le flake.

Téléchargement manuel de binaires

Téléchargez les archives depuis la page des Releases.

Artefacts

Plateforme	Modèle d’artefact	Contenu
Linux	`composia_<version>_linux_<arch>.tar.gz`	`composia`, `composia-controller`, `composia-agent`, unités systemd
macOS	`composia_<version>_darwin_<arch>.tar.gz`	`composia`
Windows	`composia_<version>_windows_<arch>.zip`	`composia.exe`

Architectures Linux : amd64, arm64, armv7, 386, riscv64.

Architectures macOS : amd64, arm64.

Architectures Windows : amd64, arm64, 386.

Installation après téléchargement

Archive Linux :

tar xzf composia_<version>_linux_<arch>.tar.gz
sudo install -m 755 composia composia-controller composia-agent /usr/local/bin/

Archive macOS :

tar xzf composia_<version>_darwin_<arch>.tar.gz
sudo install -m 755 composia /usr/local/bin/

Archive Windows :

Expand-Archive composia_<version>_windows_<arch>.zip -DestinationPath .

Placez composia.exe quelque part dans %PATH%.

Vérifier les sommes de contrôle

Téléchargez checksums.txt depuis la même release et vérifiez l’artefact téléchargé avec l’outil SHA-256 de votre plateforme.

Services système

Les paquets Linux installent des unités systemd inactives pour le contrôleur et l’agent. Les unités ne sont pas activées ni démarrées automatiquement.

Les unités empaquetées utilisent les chemins de configuration par défaut :

Service	Chemin de configuration
`composia-controller.service`	`/etc/composia/controller/config.yaml`
`composia-agent.service`	`/etc/composia/agent/config.yaml`

The packaged units use the default config paths, run as root as shipped, and do not create config files, data directories, or Git repositories for you. Bootstrap them before enabling services:

sudo install -d -m 0755 /etc/composia/controller /etc/composia/agent
sudo install -d -m 0750 \
  /var/lib/composia/controller/repo \
  /var/lib/composia/controller/state \
  /var/lib/composia/controller/logs \
  /var/lib/composia/agent/repo \
  /var/lib/composia/agent/state
sudo chown -R root:root /etc/composia /var/lib/composia
sudo git -C /var/lib/composia/controller/repo init
sudo git -C /var/lib/composia/agent/repo init

Use matching paths in the two config files:

/etc/composia/controller/config.yaml

controller:
  repo_dir: "/var/lib/composia/controller/repo"
  state_dir: "/var/lib/composia/controller/state"
  log_dir: "/var/lib/composia/controller/logs"

/etc/composia/agent/config.yaml

agent:
  repo_dir: "/var/lib/composia/agent/repo"
  state_dir: "/var/lib/composia/agent/state"

Verify ownership, write access, and Git initialization:

stat -c '%U:%G %a %n' \
  /var/lib/composia/controller/repo \
  /var/lib/composia/controller/state \
  /var/lib/composia/controller/logs \
  /var/lib/composia/agent/repo \
  /var/lib/composia/agent/state
sudo test -w /var/lib/composia/controller/repo
sudo test -w /var/lib/composia/agent/repo
sudo git -C /var/lib/composia/controller/repo rev-parse --is-inside-work-tree
sudo git -C /var/lib/composia/agent/repo rev-parse --is-inside-work-tree

If you add a systemd drop-in with User=, chown these paths to that service user instead.

Après avoir créé les fichiers de configuration, activez les services explicitement :

sudo systemctl enable --now composia-controller.service
sudo systemctl enable --now composia-agent.service

Les archives Linux incluent les mêmes unités sous packaging/systemd/. Si vous installez les binaires d’archive sous /usr/local/bin, modifiez les chemins ExecStart avant de les activer.

Dernière modification juil. 16, 2026 • Renovate Bot

Docker Compose Configuration