GET STARTED

Your personal media server in minutes

QUICK INSTALL

One Command Installation

macOSLinuxWindows
curl -fsSL https://dl.pixelbrite.site/install | sh

Auto-detects your system, downloads the right binary, and installs to ~/.local/bin (no sudo required).

Environment Variables

Customize the installation with environment variables:

Full package install to custom directory (binary + web client)
PIXELBRITE_DIR=/opt/pixelbrite curl -fsSL https://dl.pixelbrite.site/install | sh

Or download manually:

FIRST STEPS

1

Run PixelBrite

./pixelbrite

The server starts and displays access URLs. Data is stored in ./pixelbrite_data by default.

2

Create Your Account

First run launches a setup wizard to create your admin account via the web interface.

3

Add Media Libraries

Point PixelBrite to your media folders:

  • Movies - Auto-matched with metadata and artwork
  • TV Shows - Season and episode tracking
  • Music - Artist, album, and track organization
4

Start Streaming

Access PixelBrite from any device on your network. Works on phones, tablets, desktops, and smart TVs.

OPTIONS

$ pixelbrite --help
Usage of pixelbrite: -api-host string Host to bind (default "0.0.0.0") -api-port string Port for server (default "6262") -auto-port Auto-find available ports -data-dir string Directory for database and data -service-install Install as a system service -service-uninstall Remove from system services

Common Use Cases

Custom data directory
pixelbrite --data-dir /mnt/media/data
Custom port
pixelbrite --api-port 8080
Auto-select ports
pixelbrite --auto-port
Start at boot
pixelbrite --service-install

RUN AT BOOT

pixelbrite --service-install
macOS
LaunchAgent
Linux
systemd user service
Windows
Task Scheduler

No root/admin privileges required

Runs in user space

Use --service-uninstall to remove

READY TO START?

Install PixelBrite and start streaming in minutes.