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=    # openssl rand -hex 32
CONFIG_SECRET_KEY= # python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
TMDB_API_KEY=      # Votre clé TMDB

PG_USER=streamfusion
PG_PASS=streamfusion     # openssl rand -hex 16
PG_BASE=streamfusion
POSTGRES_USER=streamfusion
POSTGRES_PASSWORD=streamfusion  # même valeur que PG_PASS
POSTGRES_DB=streamfusion

MEILI_MASTER_KEY=  # openssl rand -hex 32

TZ=Europe/Paris
USE_HTTPS=true
PROXY_URL=http://warp:1080
EOF

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

2b. (Optionnel) Activer un compte debrid ou indexeur partagé

Si vous souhaitez qu'un compte debrid ou une clé d'indexeur soit accessible à tous les utilisateurs de l'instance :

nano user.env  # utiliser le template de la page Environnement, décommenter les tokens souhaités

Puis décommenter les lignes env_file: user.env dans docker-compose.yml sur les services stream-fusion et taskiq-worker. Voir Fichiers d'environnement pour les détails.

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