Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ShaneIsrael/fireshare/llms.txt

Use this file to discover all available pages before exploring further.

Fireshare lets you host your own media library and share individual videos or images with anyone via a unique link — no accounts required for viewers. Built for gamers and self-hosters, it supports public and private feeds, password-protected videos, automatic game organization, and video transcoding for adaptive quality streaming.

Quickstart

Deploy Fireshare with Docker Compose and start sharing in minutes.

Configuration

Full reference for every environment variable Fireshare supports.

Transcoding

Set up CPU or NVIDIA GPU transcoding for adaptive quality streaming.

Sharing & Privacy

Control public vs. private visibility, password-protect individual videos.

What Fireshare Does

Fireshare scans a folder of video (and image) files you mount into the container, generates thumbnails, and makes each file browsable and shareable. Every video gets a unique watch URL you can share with anyone — they don’t need an account.

Video Library

Auto-scanned library with card and list views, sorting, and search.

Uploads

Browser-based uploads for admins and optionally for public users.

Game Organization

Automatic game detection with SteamGridDB cover art and folder rules.

Image Library

Share screenshots and artwork alongside your video clips.

File Manager

Bulk rename, move, delete, and manage privacy from a single view.

Notifications

Discord and generic webhook alerts on new uploads.

Get Running in Three Steps

1

Copy the Docker Compose file

Grab the sample docker-compose.yml from the Quickstart and update the volume paths to point at your media directories.
2

Set your credentials and domain

Set ADMIN_USERNAME, ADMIN_PASSWORD, SECRET_KEY, and DOMAIN in the environment block. The DOMAIN variable is required for shareable link previews to work correctly.
3

Start the container

Run docker-compose up -d and open http://localhost:8080. Fireshare will scan your /videos directory and populate the library automatically within a few minutes.

Supported Video Formats

Fireshare serves the original file directly to the viewer without re-encoding. The supported containers are MP4 (.mp4), Apple MP4 (.m4v), QuickTime (.mov), and WebM (.webm). Supported codecs include H.264 (AVC), H.265 (HEVC), AV1, and VP9.
Enable transcoding to generate lower-quality variants (480p, 720p, 1080p) so viewers on slow connections can pick a quality that works for them.

Build docs developers (and LLMs) love