selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Stash logo

Self-host Stash

v0.32.0

Media organizer and streaming server for adult collections

ReleaseOpen SourceAGPL-3.0
Updatedlast week
LanguageGo
Setup difficultyEasy
MobileResponsive
Stars
13 405
Port
9999 (HTTP web interface and video streaming)
Requires
Ffmpeg
Docker
stashapp/stash
Install with Docker Compose
Scene list view of the indexed video libraryScene player page streaming a video in the browserScene edit form for curating metadata and tagsPerformer index gridIndividual performer pageStudio index gridIndividual studio page

What is Stash?

Stash is a Go web application you run on your own machine to catalogue and watch a personal video and image collection, adult content included. It scans the library directories you configure, fingerprints files, generates previews and sprites, and lets you rate and tag scenes, images, galleries, performers, studios and movies. Metadata can be pulled in through community scrapers or from StashDB and other stash-box databases, and the app is extensible via community-built plugins. Playback streams straight to a browser on desktop, tablet or phone, with optional hardware-accelerated live transcoding, HLS/DASH delivery and DLNA. Operators install it from release binaries for Windows, macOS and Linux, or use the official stashapp/stash image with a sample compose file; an optional username and password can protect the UI, and an API key can be issued for external systems. It is AGPL-licensed, free, maintained by volunteers, and keeps its data in an embedded SQLite database.

Stash alternatives

All self-hosted alternatives to PornHub →

Should you self-host Stash?

Stash scores 76/100 on selfhost.directory (how scoring works) and ranks #3 of 141 in Media Management. It has 13 405 GitHub stars, +318 in the last 30 days.

It shipped 6 stable releases in the past year. The latest, v0.32.0, came out on 2 November 2026. New versions land roughly every 2 months.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is Sonarr (80/100, 17 717 stars). It scores higher overall, so compare the two before you pick. See Stash vs Sonarr side by side.

Features

  • Activity Tracking
  • API Access
  • Custom CSS and JavaScript
  • DLNA
  • Filename metadata parsing
  • Hardware-accelerated transcoding
  • HLS and DASH streaming
  • Image galleries
  • Library Scanning
  • Metadata Scraping
  • Performer and tag statistics
  • Plugin System
  • Rating and tagging
  • Scene markers
  • Video Streaming

Stash README

Stash

Build Docker pulls GitHub Sponsors Open Collective backers Go Report Card Discord GitHub release (latest by date) Codeberg Translate GitHub issues by-label

Stash is a self-hosted webapp written in Go which organizes and serves your diverse content collection, catering to both your SFW and NSFW needs.

Screenshot of Stash web application interface

How to install Stash

Install Stash with Docker Compose

Only `docker` is required.
Environment variables
STASH_STASH, STASH_GENERATED, STASH_METADATA, STASH_CACHE, STASH_PORT, TZ
  • Download and save docker-compose.yml file from our GitHub.
  • Modify the docker-compose.yml file to your preferences.
  • Open terminal in the same directory as saved docker-compose.yml or cd to that directory.
  • Run docker compose up -d.
  • Installing this way will bound Stash to port 9999.
  • If everything went well Stash will be available at http://localhost:9999 locally or on your network http://YOUR-LOCAL-IP:9999.

The container ships with everything needed to run Stash, including ffmpeg.

How to configure Stash

  • STASH_STASHContainer path for the media collection library.
  • STASH_GENERATEDContainer path for generated content (screenshots, previews, transcodes, sprites).
  • STASH_METADATAContainer path where Stash's metadata lives.
  • STASH_CACHEContainer path for cache content.
  • STASH_PORT9999Port Stash serves on; must match the container's exposed port in the compose file.

Stash releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Media Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…