---
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]]
