Getting Started

Get h3xed running on your Linux server with a single command. The installer handles everything — Node.js, ffmpeg, systemd service — then opens a browser-based setup wizard.

Install

Run this on your Linux server:

curl -fsSL https://h3xed.app/install.sh | sudo bash

The installer will:

Install Node.js 22 and ffmpeg (if not already present)
Download h3xed to /opt/hexed
Create a hexed system user
Set up a systemd service (auto-starts on boot)
Start the server

When it finishes, you'll see:

  h3xed installed successfully! 🎉

  Open your browser to finish setup:

    http://YOUR_IP:32500/setup

Supported distros: Ubuntu, Debian, Fedora, RHEL, CentOS, Rocky, Alma, Arch, Manjaro. The installer auto-detects your package manager.

Setup Wizard

Open the URL shown by the installer in your browser. The setup wizard walks you through everything:

Create your admin account — set a username and password
Name your server — give it a friendly name
TMDb API key — free at themoviedb.org, used for poster art and metadata
Configure transcoding — auto-detects your GPU (NVIDIA NVENC, Intel Quick Sync, AMD VAAPI)
Add your media libraries — point to your Movies / TV Shows / Anime folders
Run initial scan — indexes your media and fetches metadata
Link to h3xed.app — enables remote access and cloud login (recommended)

Remote Access

During setup, you can link your server to h3xed.app. This creates a relay tunnel so you and your users can access the server from anywhere — no port forwarding or nginx required.

For custom domain setups, see Server Setup.

Start Watching

Once setup is complete:

Web: Go to h3xed.app/watch and sign in with your h3xed.app account
macOS: Download the desktop app from Downloads
Admin panel: Access the server admin at http://YOUR_IP:32500/app/

Share with Friends & Family

Invite people from the macOS app or admin panel — enter their email, select which libraries to share, and send them the invite link. They create an h3xed.app account and your server appears in their app automatically. See Users & Access.

Managing Your Server

# Check status
sudo systemctl status hexed

# View logs
sudo journalctl -u hexed -f

# Restart
sudo systemctl restart hexed

# Update to latest version
cd /opt/hexed && sudo -u hexed git pull origin main && sudo -u hexed npm install --omit=dev && sudo systemctl restart hexed

Next Steps

Server Setup — nginx reverse proxy, SSL, GPU transcoding details
Users & Access — invites, permissions, content restrictions
API Reference — full endpoint documentation