Vulture/VContainers/README.md

# VContainer - Vulture build script

Construction et lancements des containers.
Toutes les commandes sont à taper depuis la racine du dépôt.

## Upgrade :

```bash
git pull
podmane-compose build
systemctl --user restart vulture-stack.service
pkill -u vulture cage
```

## Build

```bash
podman-compose build
```

## Run

`podman-compose up -d`

## Stop

`podman-compose down`

## Installation

### Automatisation au boot (User Mode)

#### Étape A : Activer la persistance de l'utilisateur

Par défaut, Fedora tue les processus utilisateurs à la déconnexion. On active le "lingering" pour que vos containers tournent dès le boot :

```bash
sudo loginctl enable-linger $USER
```
#### Étape B : Créer l'unité Systemd

Créez le dossier pour les services utilisateurs : `mkdir -p ~/.config/systemd/user/`

Créez le fichier ~/.config/systemd/user/vulture-stack.service :
```TOML
[Unit]
Description=Vulture Project Stack (Podman Compose)
After=network-online.target

[Service]
Type=simple
WorkingDirectory=%h/Vulture
# Lancement au boot
ExecStart=/usr/bin/podman-compose up
# Arrêt propre
ExecStop=/usr/bin/podman-compose down
Restart=always

[Install]
WantedBy=default.target
```

#### Étape C : Activer le service

```bash
systemctl --user daemon-reload
systemctl --user enable vulture-stack.service
systemctl --user start vulture-stack.service
```

## Surveillance des Containers (Backend)

Puisque la stack tourne en mode utilisateur via Systemd, les commandes standard doivent être préfixées par `--user`.

* **Vérifier l'état de la stack :**
```bash
systemctl --user status vulture-stack.service

```


* **Consulter les logs en temps réel (équivalent `tail -f`) :**
```bash
journalctl --user -u vulture-stack.service -f

```


* **Redémarrer proprement toute la stack :**
```bash
systemctl --user restart vulture-stack.service

```


* **Lister les containers actifs :**
```bash
podman ps

```

## Tip

Pour permettre à Podman d'utiliser les ports privilégiés (<1024) :
```bash
sudo sysctl -w net.ipv4.ip_unprivileged_port_start=80
```