Aller au contenu

Premier démarrage

Ce guide vous accompagne pour déployer Stream Fusion Reborn en quelques minutes avec Docker.

Image Docker uniquement

L'image Docker officielle est disponible sur Docker Hub. Pour obtenir l'accès au dépôt privé et participer au développement, venez vous présenter sur le serveur Discord.

Prérequis

Services debrid

Les services debrid ne sont pas obligatoires au démarrage. Vous pouvez les configurer plus tard depuis la page de configuration du plugin. Si un service debrid est configuré au niveau serveur (via variables d'environnement), il sera utilisé pour tous les utilisateurs.

Étapes d'installation

1. Créer le répertoire de déploiement

mkdir stream-fusion && cd stream-fusion

2. Créer le fichier .env

cat > .env << 'EOF'
SECRET_API_KEY=   # Générer avec: openssl rand -hex 32
CONFIG_SECRET_KEY= # Générer avec: python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
TMDB_API_KEY=     # Votre clé TMDB
PEER_MASTER_KEY=   # Générer avec: openssl rand -hex 32

TZ=Europe/Paris
USE_HTTPS=True

POSTGRES_USER=streamfusion
POSTGRES_PASSWORD=  # Générer avec: openssl rand -hex 16
POSTGRES_DB=streamfusion

MEILI_MASTER_KEY=   # Générer avec: openssl rand -hex 16
EOF

Les variables SECRET_API_KEY, CONFIG_SECRET_KEY, TMDB_API_KEY et PEER_MASTER_KEY sont obligatoires. Voir la page Environnement pour les commandes de génération de clés.

3. Créer le docker-compose.yml

Choisissez votre configuration :

Voir la page docker-compose simple pour le fichier complet.

Voir la page docker-compose production pour le fichier complet.

4. Lancer l'application

docker compose up -d

5. Vérifier l'installation

curl http://localhost:8080/api/monitoring/health
docker compose logs -f stream-fusion

6. Accéder aux interfaces

URL Description
http://localhost:8080/ Page de configuration du plugin Stremio
http://localhost:8080/admin/ Panneau d'administration
http://localhost:8080/api/monitoring/health Health check

Si vous utilisez un domaine avec HTTPS (ex: sf.example.com), l'interface d'administration est accessible à https://sf.example.com/admin/.

Créer une clé API

  1. Allez sur https://votre-domaine.tld/admin/ (ou http://localhost:8080/admin/)
  2. Authentifiez-vous avec votre SECRET_API_KEY
  3. Allez dans l'onglet Sécurité puis Clés API
  4. Créez une nouvelle clé avec les options suivantes :
    • Nom d'utilisateur : identifiant optionnel
    • Durée de validité : date d'expiration optionnelle
    • Proxyfication des flux : activer/désactiver pour cette clé
    • Permissions : mettre en pause la clé à tout moment
curl -X POST http://localhost:8080/api/auth/new \
  -H "secret-key: votre-secret-api-key" \
  -H "Content-Type: application/json" \
  -d '{"name": "ma-cle-stremio"}'

Inscription publique

Vous pouvez activer l'inscription publique via le panneau d'administration ou la variable d'environnement ALLOW_PUBLIC_KEY_REGISTRATION=True. Dans ce cas, depuis la page de configuration du plugin Stremio, les utilisateurs pourront créer leur propre clé API automatiquement.

Instance publique

L'inscription publique est destinée aux instances ouvertes. Pour une instance privée, préférez créer les clés manuellement via le panneau d'administration.

Configurer Stremio

Voir le guide détaillé : Configuration Stremio.

Prochaines étapes