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.

sharebox logo

Self-host sharebox

v5.1.0

Lightweight self-hosted media streaming server

ReleaseOpen SourceMIT
Updated4 months ago
LanguageJavaScript
Setup difficultyModerate
ThemeDark mode
Stars
28
RAM
256 MB
Port
80 (HTTP web server)
Requires
Ffmpeg, nginx or Apache, PHP
Docker
ghcr.io/ohugonnot/sharebox
Install with Docker Compose
Netflix-style grid view with TMDB postersSeries grid view with season posters

What is sharebox?

ShareBox is a PHP-based media server for streaming videos and sharing files by link, without the overhead of traditional media servers. It skips library scanning, uses SQLite instead of a database server, and requires no viewer accounts. Video transcoding happens on-the-fly via ffmpeg with three automatic modes: direct play for H.264/MP4, remux for H.264/MKV, and full transcode for HEVC/AV1. GPU acceleration works with Intel VAAPI, NVIDIA NVENC, and Raspberry Pi V4L2M2M. The UI includes a poster grid using TMDB metadata, a custom player with subtitles and quality options, a PDF reader, an audiobook player, password-protected share links with expiry, and an admin dashboard. It runs on minimal hardware — 256 MB RAM or a Raspberry Pi 4 — and deploys via Docker Compose, a one-line installer, or manual setup.

Should you self-host sharebox?

sharebox scores 38/100 on selfhost.directory (how scoring works) and ranks #48 of 54 in Media Streaming. It has 28 GitHub stars.

It shipped 2 stable releases in the past year. The latest, v5.1.0, came out on 20 June 2026. New versions land roughly every 4 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is Jellyfin (88/100, 58 737 stars). It scores higher overall, so compare the two before you pick. See sharebox vs Jellyfin side by side.

Features

  • Admin Panel
  • Audiobook/album player
  • Custom Video Player
  • GPU hardware transcoding
  • Netflix-style poster grid
  • On-the-fly video transcoding
  • PDF reader
  • Secure file sharing

sharebox README

How to install sharebox

Install sharebox with Docker Compose

Docker and Docker Compose
Environment variables
SHAREBOX_ADMIN_USER, SHAREBOX_ADMIN_PASS, SHAREBOX_MEDIA_DIR, SHAREBOX_TMDB_API_KEY, SHAREBOX_DEMO_DATA, SHAREBOX_STREAM_MAX_CONCURRENT, SHAREBOX_STREAM_REMUX_ENABLED, SHAREBOX_BANDWIDTH_QUOTA_TB

git clone https://github.com/ohugonnot/sharebox.git && cd sharebox

Edit docker-compose.yml to add your media path

docker compose up -d

Recommended method. Demo content included by default.

How to configure sharebox

  • BASE_PATH/path/to/your/files/Root directory for file browsing and sharing

    Root directory for file browsing and sharing

  • DB_PATH__DIR__ . '/data/share.db'Path to the SQLite database

    Path to the SQLite database

  • DL_BASE_URL/dl/Base URL for public download links

    Base URL for public download links

  • FFMPEG_HW_ACCELautoHardware transcoding mode

    Hardware transcoding mode

    values: auto|vaapi|nvenc|v4l2m2m|none

  • MAX_ZIP_SIZE10 * 1024 * 1024 * 1024Maximum total size allowed for ZIP downloads

    Maximum total size allowed for ZIP downloads

  • READER_EPUB_ENABLEDfalseEnable EPUB support in reader

    Enable EPUB support in reader

    values: true|false

  • SHAREBOX_ADMIN_PASSshareboxAdmin panel password

    Admin panel password

  • SHAREBOX_ADMIN_USERadminAdmin panel username

    Admin panel username

  • SHAREBOX_BANDWIDTH_QUOTA_TB100Monthly bandwidth quota for dashboard

    Monthly bandwidth quota for dashboard

  • SHAREBOX_DEMO_DATAfalseCreate rich sample media on first start

    Create rich sample media on first start

    values: true|false

  • SHAREBOX_MEDIA_DIR/media/Media path inside the container

    Media path inside the container

  • SHAREBOX_STREAM_MAX_CONCURRENT4Max simultaneous ffmpeg processes

    Max simultaneous ffmpeg processes

  • SHAREBOX_STREAM_REMUX_ENABLEDfalseEnable remux for H.264 MKV (experimental)

    Enable remux for H.264 MKV (experimental)

    values: true|false

  • SHAREBOX_TMDB_API_KEYTMDB API key for poster grid

    TMDB API key for poster grid

  • XACCEL_PREFIX/internal-downloadX-Accel-Redirect prefix for nginx

    X-Accel-Redirect prefix for nginx

sharebox releases & version history

More in Media Streaming

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…