Aller au contenu principal

Installation avec Docker

Ygégé est disponible sous forme d'image Docker officielle multi-architecture. Ce guide explique comment déployer et configurer le service.

Prérequis​

  • Docker installé sur votre système
  • Docker Compose (recommandé pour une gestion simplifiée)
  • Un compte YGG Torrent valide

Installation rapide​

Avec Docker Run​

docker run -d \
  --name ygege \
  -p 8715:8715 \
  -v ./config:/config \
  -e YGG_USERNAME="votre_nom_utilisateur" \
  -e YGG_PASSWORD="votre_mot_de_passe" \
  uwudev/ygege:latest

Avec Docker Compose​

Créez un fichier compose.yml:

services:
  ygege:
    image: uwudev/ygege:latest
    container_name: ygege
    restart: unless-stopped
    ports:
      - "8715:8715"
    volumes:
      - ./config:/config
    environment:
      YGG_USERNAME: "votre_nom_utilisateur"
      YGG_PASSWORD: "votre_mot_de_passe"
      LOG_LEVEL: "info"
    healthcheck:
      test: ["CMD-SHELL", "curl --fail http://localhost:8715/health || exit 1"]
      interval: 1m30s
      timeout: 20s
      retries: 3
      start_period: 10s

Puis démarrez le service:

docker compose up -d

Configuration​

Avec fichier config.json​

Créez un fichier config/config.json:

{
    "username": "votre_nom_utilisateur",
    "password": "votre_mot_de_passe",
    "bind_ip": "0.0.0.0",
    "bind_port": 8715,
    "log_level": "info"
}

Avec variables d'environnement​

Les variables suivantes sont supportées:

VariableDescriptionDéfaut
YGG_USERNAMENom d'utilisateur YGG-
YGG_PASSWORDMot de passe YGG-
BIND_IPAdresse IP d'écoute0.0.0.0
BIND_PORTPort d'écoute8715
LOG_LEVELNiveau de log (trace, debug, info, warn, error)info

Tags Docker disponibles​

TagDescription
latestDernière version stable
stableAlias de latest
noupxVersion sans compression UPX (pour Synology)
0.6.2Version spécifique
developVersion de développement

Pour les systèmes avec architectures anciennes​

Si vous rencontrez des erreurs de segmentation (segfault) sur des architectures anciennes ou certains NAS (comme Synology), utilisez l'image noupx:

services:
  ygege:
    image: uwudev/ygege:noupx
    # ... reste de la configuration

Vérification​

Une fois le conteneur démarré, vérifiez qu'il fonctionne:

curl http://localhost:8715/health

Vous devriez recevoir une réponse OK.

Prochaines étapes​