Le canal alpha donne accès aux dernières fonctionnalités avant leur passage en stable. Version actuelle : v0.5.x (Brownberry).
Le canal alpha peut contenir des bugs. Recommandé pour les tests ou les environnements non-critiques.
curl -fsSL https://raw.githubusercontent.com/Gaiver-IT/caleope/alpha/install.sh | bash
# → choisir "2) Alpha" quand demandé
CALEOPE_DOMAIN=home.local \
CALEOPE_PROXY_MODE=standalone \
CALEOPE_CHANNEL=alpha \
bash <(curl -fsSL https://raw.githubusercontent.com/Gaiver-IT/caleope/alpha/install.sh)
Modes proxy disponibles :
| Mode | Usage |
|---|---|
standalone |
LAN/hors-ligne, HTTP uniquement, pas de Let's Encrypt |
npm |
Derrière NPM/Caddy existant |
traefik |
HTTPS automatique avec Let's Encrypt |
# Synchroniser le catalogue d'apps (branche alpha)
sudo git -C /opt/gaiver-it/caleope/core/cache/official fetch origin alpha
sudo git -C /opt/gaiver-it/caleope/core/cache/official reset --hard origin/alpha
# Puis mettre à jour le catalogue côté daemon
caleope update
sudorequis car le cache est owned par root.
Les ports des applications sont alloués dynamiquement par Caleope à l'installation (aucune configuration manuelle requise). Le port alloué est visible dans caleope list.
caleope list
# → jellyfin ✅ actif 8001 official
# Installer une app avec accélération GPU (NVIDIA ou Intel auto-détecté)
caleope install jellyfin --gpu
# Vérifier l'overlay généré
cat /opt/gaiver-it/caleope/apps-installed/jellyfin/compose.override.yml
# Prérequis : installer restic
caleope install restic
# Backup vers dépôt local
caleope backup jellyfin --restic --repo /mnt/backup/caleope --password <pass>
# Backup vers SFTP
caleope backup jellyfin --restic \
--repo sftp:user@backup-host:/backups/caleope \
--password <pass>
# Voir les snapshots (dépôt owned root → sudo)
sudo sh -c 'RESTIC_PASSWORD=<pass> restic -r /mnt/backup/caleope snapshots'
Installe Caleope sans Let's Encrypt — idéal pour un réseau local sans DNS public :
CALEOPE_PROXY_MODE=standalone bash install.sh
Traefik écoute en HTTP pur sur le port 80, pas de certificats requis.
L'API REST (:8765) est limitée à 60 requêtes/minute par IP. Au-delà :
HTTP 429 Too Many Requests
Retry-After: 60
Traefik applique automatiquement des headers de sécurité sur toutes les réponses :
X-Content-Type-Options: nosniffX-Frame-Options: DENYStrict-Transport-Security (HTTPS uniquement)Server: et X-Powered-By:caleope remove)# Avec confirmation
caleope remove jellyfin
# Sans confirmation (scripts/CI)
caleope remove jellyfin -y
caleope remove jellyfin --yes
# Vérifier la version actuelle
caleope version
# Mettre à jour (télécharge la dernière pre-release)
caleope upgrade
Séquence de test recommandée sur un Debian 12 fresh :
# 1. Install
CALEOPE_DOMAIN=home.local CALEOPE_PROXY_MODE=standalone CALEOPE_CHANNEL=alpha \
bash <(curl -fsSL https://raw.githubusercontent.com/Gaiver-IT/caleope/alpha/install.sh)
# 2. Vérifier
caleope ping
caleope version # → v0.5.x
# 3. Sync store
sudo git -C /opt/gaiver-it/caleope/core/cache/official fetch origin alpha
sudo git -C /opt/gaiver-it/caleope/core/cache/official reset --hard origin/alpha
caleope update
# 4. Installer des apps
caleope install authentik
caleope install jellyfin
caleope install restic
# 5. Test GPU (si disponible)
caleope install jellyfin --gpu
cat /opt/gaiver-it/caleope/apps-installed/jellyfin/compose.override.yml
# 6. Test Restic
caleope backup jellyfin --restic --repo /tmp/test-backup --password testpass123
sudo sh -c 'RESTIC_PASSWORD=testpass123 restic -r /tmp/test-backup snapshots'
# 7. Test rate limiting
TOKEN=$(caleope token | grep Token | awk '{print $NF}')
for i in $(seq 1 62); do
code=$(curl -s -o /dev/null -w "%{http_code}" \
-H "Authorization: Bearer $TOKEN" http://localhost:8765/api/v1/apps)
echo "req $i → $code"
done
# 8. Test suppression sans confirmation
caleope install freshrss
caleope remove freshrss --yes