---
title: "Deploy Navidrome | (Just Updated) Self-Hosted Music Streaming Server, Subsonic API, Spotify Alternative, Admin Login Generated"
description: "Navidrome self-hosted music streaming server, Subsonic API, admin generated"
category: "Storage"
url: https://railway.com/deploy/navidrome-or-just-updated-self-hosted-mu
---

# Deploy Navidrome | (Just Updated) Self-Hosted Music Streaming Server, Subsonic API, Spotify Alternative, Admin Login Generated

Navidrome self-hosted music streaming server, Subsonic API, admin generated

**[Deploy Navidrome | (Just Updated) Self-Hosted Music Streaming Server, Subsonic API, Spotify Alternative, Admin Login Generated on Railway](https://railway.com/template/navidrome-or-just-updated-self-hosted-mu)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/navidrome-or-just-updated-self-hosted-mu/manifest.json

- **Creator:** SuperSlowSloth
- **Category:** Storage

## Template content

### navidrome

- **Image:** ghcr.io/bon5co/navidrome-railway:0.64.2@sha256:b18d5e18c0cd35482fce6328342aa105b2fed06e45a259bd006885178cd69893
- **Health check:** /ping
- **Public domain:** Yes

## Documentation

# Deploy and Host Navidrome on Railway

**Built for an LLM agent to deploy and use.** The deploy form has no fields to fill: the administrator account is created at first boot with a generated password, nobody can claim the instance first, and the database and the music library live on a volume. Navidrome is a self-hosted music streaming server that speaks the Subsonic and OpenSubsonic APIs, a self-hosted alternative to Spotify, Plex and Jellyfin for your own music, streamed to any Subsonic client app.

## About Hosting Navidrome

This template runs one service, **navidrome**: the upstream Navidrome v0.64.2 image, pinned by digest, through a thin wrapper, with a volume at `/data` that holds the database, the cache and the music library at `/data/music`. One public domain serves the web player, the native REST API and the Subsonic API. The server listens on Railway's injected `PORT`, and the healthcheck is `GET /ping`.

**What the wrapper fixes.** Upstream Navidrome shows a create-administrator page and, while no user exists, accepts an anonymous `POST /auth/createAdmin` that makes the caller the administrator, so on a public domain the first visitor owns the instance and its library. It also listens on port 4533 baked into the image and ignores Railway's `PORT`, and it keeps data and music on two volumes where Railway allows one per service. The wrapper refuses to start if `ADMIN_PASSWORD` is empty or shorter than 8 characters, has upstream seed the administrator `admin` from it on the first boot before the server accepts a request, so the first-user route is gone from then on, listens on `PORT`, and puts the music library under the one volume. Measured on an unmodified `deluan/navidrome:0.64.2` run locally: an anonymous `POST /auth/createAdmin` answered 200 with `isAdmin` true. On the wrapper the same call answers 403 `Cannot create another first admin`. Not reproduced on a Railway control of the incumbent listing.

**Using it.** Open the domain and sign in as `admin` with `ADMIN_PASSWORD`. Put music in `/data/music` (for example with `railway ssh`, or set a `MUSIC_ARCHIVE_URL` variable to a `.zip`, `.tar`, `.tar.gz` or `.tgz` link and the first boot unpacks it into an empty library); Navidrome scans it and the albums appear. Point any Subsonic client (DSub, Symfonium, Amperfy, Feishin, Supersonic) at the domain with the same username and password. `ADMIN_PASSWORD` is read at the first boot only; change the password in the web player afterwards, and redeploys keep the same account. Upstream's first-boot message prints the generated password once in the deploy log, which only you can read.

### Agent contract

- Public URL: `https://RAILWAY_PUBLIC_DOMAIN` (the generated domain of the `navidrome` service)
- Private URL: `http://navidrome.railway.internal:8080`
- Credentials: the variable `ADMIN_PASSWORD` on the `navidrome` service is the password of the administrator `admin`
- Auth: `POST /auth/login` with a JSON body of `username` and `password` returns `token`; send it as the header `X-ND-Authorization` with the value `Bearer` plus a space plus the token on every `/api` call. The Subsonic API at `/rest` takes `u`, `p`, `v`, `c` and `f` query parameters with the same login. Without the token a write answers 401. Public sign-up is closed.
- Health: `GET /ping` returns 200 without credentials

```bash
#!/bin/sh
# needs: RAILWAY_PUBLIC_DOMAIN, ADMIN_PASSWORD (variables of the navidrome service); also curl, sed, grep.
R="https://$RAILWAY_PUBLIC_DOMAIN"
J="Content-Type: application/json"
STAMP=$(date +%s)
n=0; until [ "$(curl -s -o /dev/null -w '%{http_code}' "$R/ping")" = 200 ]; do n=$((n+1)); [ "$n" -le 60 ] || break; sleep 5; done
curl -s -o /dev/null -w "health: %{http_code}\n" "$R/ping"
# a stranger cannot become the administrator: the first-user route answers 403 once an administrator exists
curl -s -X POST -H "$J" -d "{\"username\":\"stranger$STAMP\",\"password\":\"pw$STAMP$STAMP\"}" "$R/auth/createAdmin" -o /dev/null -w "public signup: %{http_code}\n"
# a stranger cannot write: creating a user without a token or with a wrong one is refused
BODY="{\"userName\":\"x$STAMP\",\"name\":\"x$STAMP\",\"password\":\"pw$STAMP$STAMP\",\"email\":\"x$STAMP@example.com\"}"
curl -s -X POST -H "$J" -d "$BODY" "$R/api/user" -o /dev/null -w "write without key: %{http_code}\n"
curl -s -X POST -H "$J" -H "X-ND-Authorization: Bearer not-a-token" -d "$BODY" "$R/api/user" -o /dev/null -w "write with wrong key: %{http_code}\n"
# a wrong password is refused, the generated one signs in as the administrator "admin"
curl -s -X POST -H "$J" -d "{\"username\":\"admin\",\"password\":\"wrong$STAMP$STAMP\"}" "$R/auth/login" -o /dev/null -w "login with wrong password: %{http_code}\n"
LOGIN=$(curl -s -X POST -H "$J" -d "{\"username\":\"admin\",\"password\":\"$ADMIN_PASSWORD\"}" "$R/auth/login")
TOKEN=$(echo "$LOGIN" | sed -n 's/.*"token":"\([^"]*\)".*/\1/p')
if [ -n "$TOKEN" ]; then echo "login with key: ok"; else echo "login with key: FAILED"; fi
# the Subsonic API that music clients speak accepts the same login and reports the library
sub() { curl -s -G --data-urlencode "u=admin" --data-urlencode "p=$ADMIN_PASSWORD" --data-urlencode "v=1.16.1" --data-urlencode "c=agent" --data-urlencode "f=json" "$R/rest/$1"; echo; }
sub ping.view | sed -n 's/.*"status":"\([a-z]*\)".*/subsonic ping: \1/p'
sub getMusicFolders.view | sed -n 's/.*"musicFolder":\[{[^}]*"name":"\([^"]*\)".*/music folder: \1/p'
# with the token a user is created and read back
curl -s -X POST -H "$J" -H "X-ND-Authorization: Bearer $TOKEN" -d "$BODY" "$R/api/user" -o /dev/null -w "write with key: %{http_code}\n"
FOUND=$(curl -s -H "X-ND-Authorization: Bearer $TOKEN" "$R/api/user" | grep -c "\"userName\":\"x$STAMP\"")
if [ "$FOUND" -ge 1 ]; then echo "user listed: found"; else echo "user listed: MISSING"; fi
```

Expected output against a fresh deploy (measured on a Railway deploy of the generated draft):

```text
health: 200
public signup: 403
write without key: 401
write with wrong key: 401
login with wrong password: 401
login with key: ok
subsonic ping: ok
music folder: Music Library
write with key: 200
user listed: found
```

The refusals are the contract: `write without key: 401` and `write with wrong key: 401` on the user create, `public signup: 403` on the first-user route, and `login with wrong password: 401`.

## Why Deploy Navidrome on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Navidrome on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

- **Agent-ready** - no deployer fields, a contract block, and one script that proves the server is healthy, a stranger can neither write nor register, and the generated password signs in on both the native and the Subsonic API.
- **Owned by you from the first request** - the administrator is seeded before the server accepts a connection, so nobody else can claim it.
- **Works on first deploy** - the listener already follows Railway's injected `PORT`.
- **Data survives redeploys** - the database, the cache and the music library live on one volume.
- **Pinned** - the upstream image is pinned by digest and the wrapper by tag and digest.

## Common Use Cases

- **Personal music streaming** - your own library in a web player and on your phone, without a subscription.
- **Subsonic server for client apps** - DSub, Symfonium, Amperfy, Feishin and Supersonic connect with a username and password.
- **Self-hosted alternative to Spotify, Plex and Jellyfin for music** - one small Go server, about 20 MiB of memory idle.

## Dependencies for Navidrome Hosting

- The navidrome service with its volume, created by the template. A music archive link is optional; add it as a `MUSIC_ARCHIVE_URL` variable before the first boot.

### Deployment Dependencies

- [Navidrome repository](https://github.com/navidrome/navidrome)
- [Navidrome documentation](https://www.navidrome.org/docs/)
- [Wrapper image source](https://github.com/bon5co/navidrome-railway)


## Similar templates

- [RustFS | (Just Updated) S3 Object Store, Public URL and Keys Set](https://railway.com/deploy/rustfs-or-just-updated-s3-object-store-p) — S3-compatible object store, keys and public URL preset, volume kept
- [TimescaleDB](https://railway.com/deploy/timescaledb-railway-template) — A PostgreSQL-based time-series database for analytics on Railway.
- [Neo4j 2026.10 Community](https://railway.com/deploy/neo4j-202610-community) — Neo4j graph database with APOC, Browser, Bolt TCP proxy and a volume

Open this page in a browser: https://railway.com/deploy/navidrome-or-just-updated-self-hosted-mu
