> [!CAUTION]
> **Under active development — expect breaking changes before 1.0.** Install instructions below are current and supported; review the release notes before upgrading.
NoMercy MediaServer
The Effortless Encoder.
Making owning movies, shows, and music just as easy as using a streaming service.
---
## Features
- **Automatic Encoding** — Convert your media files into various formats effortlessly
- **Media Management** — Organize and curate your library with rich metadata
- **Remote Streaming** — Access your collection from anywhere via [app.nomercy.tv](https://app.nomercy.tv)
- **NoMercy Connect** — Cross-client playback control and hand-off; separate watch histories and profiles across multiple servers
- **Trusted SSL** — Built-in certificate for secure internal and external access
- **No DRM** — Your files always stay on your storage, accessible regardless of account status
## Screenshots
Click to expand
### Home
### Info
### Custom Video and Trailer player
### Image Viewer
### Video Library
### Movie Collection
### Person
### Music
### Screensaver 😍 (Suck it, Netflix! Mine's prettier)
---
## Quick Start
**1. Download the installer for your platform:**
| Platform | File |
|:--|:--|
| Windows | `NoMercyMediaServer-windows-x64.exe` |
| Linux | `NoMercyMediaServer-linux-x64` |
| macOS | `NoMercyMediaServer-macos-x64.tar.gz` |
> [!NOTE]
> Installers and standalone binaries are self-contained — no .NET installation required.
> Find all downloads on the [Releases page](https://github.com/NoMercy-Entertainment/nomercy-media-server/releases/latest).
**2. Run the server and log in.**
On desktop, a browser window opens automatically for authentication. On headless servers, navigate to `http://:7626/setup` to complete setup.
**3. Open [app.nomercy.tv](https://app.nomercy.tv), add your media, and start streaming.**
That's it — you're up and running.
---
## Installation Options
### Linux Package Repository
Install from [repo.nomercy.tv](https://repo.nomercy.tv):
Debian / Ubuntu
```bash
wget -O - https://repo.nomercy.tv/nomercy_repo.gpg.pub | sudo gpg --dearmor -o /etc/apt/keyrings/nomercy-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/nomercy-archive-keyring.gpg] https://repo.nomercy.tv/apt stable main" | sudo tee /etc/apt/sources.list.d/nomercy.list
sudo apt update && sudo apt install nomercy
```
Fedora / RHEL / CentOS
```bash
sudo dnf config-manager --add-repo https://repo.nomercy.tv/rpm/nomercy.repo
sudo rpm --import https://repo.nomercy.tv/nomercy_repo.gpg.pub
sudo dnf install nomercy
```
Arch Linux
```bash
echo -e "Server = https://repo.nomercy.tv/arch-packages/pool/x86_64" | sudo tee /etc/pacman.d/nomercy-mirrorlist
echo -e "\n[nomercy]\nInclude = /etc/pacman.d/nomercy-mirrorlist" | sudo tee -a /etc/pacman.conf
curl -o nomercy.gpg.pub https://repo.nomercy.tv/nomercy_repo.gpg.pub
sudo pacman-key --add nomercy.gpg.pub
sudo pacman-key --lsign-key B8CE23865511524D442F7DCF9A4B71002C09D6B8
sudo pacman -Sy nomercy
```
### Docker
```bash
# Set your host LAN IP (required for container ↔ host communication)
export HOST_IP=$(hostname -I | awk '{print $1}')
# Pull and run — pick your variant:
docker compose up -d # CPU only
docker compose -f docker-compose.nvidia.yml up -d # NVIDIA GPU
docker compose -f docker-compose.intel.yml up -d # Intel Quick Sync
docker compose -f docker-compose.amd.yml up -d # AMD GPU
```
You can also pull images directly from the container registry:
```bash
docker pull ghcr.io/nomercy-entertainment/nomercymediaserver:latest # CPU
docker pull ghcr.io/nomercy-entertainment/nomercymediaserver:nvidia # NVIDIA
docker pull ghcr.io/nomercy-entertainment/nomercymediaserver:intel # Intel
docker pull ghcr.io/nomercy-entertainment/nomercymediaserver:amd # AMD
```
> [!IMPORTANT]
> Export `HOST_IP` before running — the compose files use it for `NOMERCY_INTERNAL_IP`. Edit the compose file to update media volume paths.
> [!IMPORTANT]
> The server derives a stable identity from the host `machine-id`, which the compose files mount read-only. If you run the image directly with `docker run` instead of compose, pass `-v /etc/machine-id:/etc/machine-id:ro` as well. Without it a recreated container reads an empty id and registers as a brand new server.
### Release Channels
Every build starts as a nightly. The same build can later be promoted to beta, then to stable. It is never rebuilt on the way, so stable runs the exact bytes that were tested as nightly and beta.
| Channel | What it is | Docker tag |
|---------|------------|------------|
| **Stable** | Promoted from beta. What the installers, the built-in updater and nomercy.tv offer. | `latest` or `stable` (plus `-nvidia`, `-intel`, `-amd`) |
| **Beta** | A nightly that was picked for wider testing. | `beta` (plus `-nvidia`, `-intel`, `-amd`) |
| **Nightly** | Every change on `dev` that passes CI. Marked as a pre-release on GitHub. | `nightly` (plus `-nvidia`, `-intel`, `-amd`) |
Every build also keeps a tag with its version, like `1.0.14` or `1.0.14-nvidia`. Pin one of those if you never want an automatic move.
The version number doesn't show the channel. A stable version can skip numbers (1.0.0, then 1.0.14), because the nightlies in between were never promoted.
For maintainers: promote a build with the **Promote Release** workflow in Actions. It refuses when CI was not green for that commit, when an asset or image is missing, or when the build was retracted. The next version line (for example `1.0`) is set in `.github/release-line`. The steps and the stable release checklist are in [`.github/RELEASING.md`](.github/RELEASING.md).
### Build from Source
Requires the [.NET 10.0 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/10.0).
```bash
git clone https://github.com/NoMercy-Entertainment/nomercy-media-server.git
cd nomercy-media-server
dotnet restore && dotnet build
dotnet run --project src/NoMercy.Service
```
---
## Configuration
### Port Forwarding
Forward port `7626` on your router to access your server from outside your home network.
### Startup Flags
| Flag | Short | Description |
|:--|:--|:--|
| `--loglevel` | `-l` | Log level (`Verbose`, `Debug`, `Information`, `Warning`, `Error`, `Fatal`) |
| `--dev` | `-d` | Run the server in development mode |
| `--internal-port` | `-i` | Internal port (default: `7626`) |
| `--external-port` | `-x` | External port (default: `7626`) |
| `--internal-ip` | | Internal IP address override |
| `--external-ip` | | External IP address override |
| `--pipe-name` | | Named pipe (Windows) or Unix socket name for IPC |
| `--service` | | Run as a platform service (Windows SCM, systemd, launchd) |
The server also listens on `InternalServerPort + 1` (default `7627`) on loopback only — an HTTP-only health check endpoint used by the Docker `HEALTHCHECK`, not reachable from outside the host.
All ongoing configuration (libraries, users, encoding profiles, connectivity mode) lives in the dashboard, served through the web app after setup. Startup flags and environment variables are bootstrap-only — they set the values needed to reach that first setup page, not a substitute for it.
---
## Credits
UI designed by [**AAOA**](https://github.com/aaoa-dev) — catch the design process live on [YouTube](https://www.youtube.com/@aaoa_streams) and [Twitch](https://twitch.tv/aaoa_). Icons and design kit available at [aaoa.lemonsqueezy.com](https://aaoa.lemonsqueezy.com).
Special thanks to **Mark** for donating hosting and the domain, and to [**Fill84**](https://github.com/Fill84) for programming contributions.
## Repository Note
> This repository was recreated in January 2026 due to repository bloat. The previous repo with full history is archived at [NoMercyMediaServer-archive](https://github.com/NoMercy-Entertainment/nomercy-media-server-archive).
## Contact
[NoMercy.tv](https://nomercy.tv) · [Discord](https://discord.gg/dHHvnvFsXR)
---
Made with ❤️ by NoMercy Entertainment