Files
wiki/Catalogue-Self-Hosted/apps/app-stash.md
T
2026-06-09 18:40:21 +02:00

105 lines
4.1 KiB
Markdown

---
title: Stash
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, photos, stash, media-manager, cataloging, nsfw, self-hosted]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=Photos, https://github.com/stashapp/stash]
---
# 📸 Stash
> **Gestionnaire et organisateur de médias personnels** — un Plex/Jellyfin spécialisé dans le catalogage de bibliothèques média, y compris pour adultes. C'est un outil de catalogage, rien de plus.
## 📋 Informations Générales
| Attribut | Valeur |
|----------|--------|
| **Nom** | Stash |
| **Slug** | app-stash |
| **Description** | Organisateur et gestionnaire de bibliothèque média (vidéo, images) |
| **Site officiel** | [stashapp.cc](https://stashapp.cc) |
| **Repository** | [stashapp/stash](https://github.com/stashapp/stash) |
| **Stars** | 12 448 ⭐ |
| **Licence** | AGPL-3.0 |
| **Langage principal** | Go, TypeScript |
| **Catégorie** | Photos |
| **Tags** | [catalogue, photos, stash, media-manager, cataloging, nsfw, self-hosted] |
## 📝 Description
**Stash** est un **gestionnaire de médiathèque** auto-hébergé. Il est souvent cité dans la catégorie "Photos" de selfh.st car il s'occupe d'**organiser, tagger, indexer et servir** une collection de fichiers média (images et vidéos). L'outil est généraliste mais historiquement adopté pour les **collections adultes** (que l'on peut cataloguer honnêtement) — de la même façon que **Plex/Jellyfin/Kodi** organisent des films.
Fonctionnalités : **scan de dossiers** récursif, **génération de vignettes** automatique, **détection de scènes** (split de fichiers vidéo), **reconnaissance d'acteurs/performers** avec base de données communautaire, **tags, studios, scènes, performers** hiérarchiques, **scrapers** de métadonnées depuis sites tiers, **lecteur intégré**, **streaming** depuis navigateur, **API GraphQL** complète, **plugins** communautaires.
À noter : la fonction de scraping des métadonnées vers des sites tiers fait partie de l'outil. Utilisable **uniquement avec vos propres fichiers** — Stash ne fournit ni ne distribue aucun contenu.
## 🚀 Installation
### Via Docker (recommandé)
```yaml
# docker-compose.yml
version: "3.8"
services:
stash:
image: stashapp/stash:latest
container_name: stash
restart: unless-stopped
ports:
- 9999:9999
environment:
STASH_STASH: /data
STASH_GENERATED: /generated
STASH_CACHE: /cache
STASH_CONFIG: /.stash
volumes:
- ./config:/.stash
- ./data:/data
- ./generated:/generated
- ./cache:/cache
- /mnt/media:/media:ro # vos fichiers média en lecture seule
```
> Le container lit vos médias en `ro` (read-only) — Stash ne modifie jamais vos fichiers sources, il génère ses propres caches/vignettes.
### Installation manuelle
Binaire Go + FFmpeg. Faisable (binaire unique) mais Docker reste plus propre.
## ⚙️ Configuration
- **Premier lancement** : assistant web sur le port 9999 pour configurer les chemins.
- **Scan** : automatique ou manuel, configurable (récursivité, exclusions, types MIME).
- **Hardware transcoding** : supporte NVENC/QSV/VA-API via FFmpeg.
- **Plugins** : marketplace intégré pour étendre scrapers et fonctionnalités.
- **Authentification** : multi-utilisateurs, sessions, API keys.
## 🔗 Alternatives
- **[[app-photoprism]]** — Photos "classiques" familiales, pas de catalogage média
- **[[app-immich]]** — Photos smartphone, pas de catalogage média
- **Plex / Jellyfin** — Pour films/séries, pas spécialisé catalogage/tagging
## 🔒 Sécurité
- **Reverse proxy HTTPS** obligatoire en prod — l'interface contient vos métadonnées.
- **Authentification** : configurer un mot de passe fort dès le premier lancement.
- **Pas d'upload anonyme** par défaut, mais vérifier les règles de partage.
## 📚 Ressources
- [Site officiel Stash](https://stashapp.cc)
- [Repository GitHub](https://github.com/stashapp/stash)
- [Documentation officielle](https://docs.stashapp.cc/)
## 🔗 Pages Liées
- [[cat-photos]] (n'existe pas encore, OK)
- [[app-photoprism]]
- [[app-traefik]]
- [[recettes-docker-compose]]
- [[securisation-home-lab]]