Deploy Feishin

Modern web music player for Navidrome, Jellyfin and Subsonic

Deploy Feishin

Just deployed

Deploy and Host self hosted Feishin (Other) on Railway

This template deploys Feishin, a web music player for a server you already run, as independent community packaging of jeffvli/feishin v1.17.0 (GPL-3.0). It is not affiliated with or endorsed by Feishin, Navidrome, or Jellyfin.

About Hosting Feishin open-source software on Railway (self hosted Feishin template)

This template runs the unmodified upstream Feishin 1.17.0 web image, which is GPL-3.0 licensed and maintained independently by the community.

Railway handles the hosting side: it builds the container, provides a public HTTPS domain, runs a health check on the root path, and restarts the service if it stops.

Why Deploy Feishin, the self-hosted web music player on Railway

Running Feishin on Railway gives you a browser player for the music server you already host, reachable from any device without installing anything.

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.

Railway hosts the public domain and the always-on process so you do not have to manage a virtual machine.

Railway vs Other Hosting Providers and VPS for Feishin self hosting

Hosting a small static web player means choosing between a managed platform and a VPS you maintain. This table compares the two for Feishin.

ProviderWhat You Get with RailwayWhat You Get with the Other Provider
DigitalOceanA managed service with HTTPS on a public URL, a health check and automatic restarts.A Droplet you control, including the web server, TLS and OS updates.
AWSA single service from this template with no IAM, VPC or load balancer setup first.Broad control over networking and scaling, with more configuration to maintain.
HetznerA managed deploy with the same public HTTPS URL and restart policy, without host work.Low-cost bare servers where you manage the OS, updates and reverse proxy yourself.

Common Use Cases for hosted Feishin

  • Family listening from one library: Point Feishin at the Navidrome, Jellyfin or Subsonic server you already run, and everyone in the house gets the same albums, playlists and queues in a browser tab.
  • Synced lyrics while you listen: Turn on synchronized or unsynchronized lyrics for the tracks that have them, and follow along as the song plays.
  • Smart playlists and scrobbling: Build smart playlists against a Navidrome server, and let playback scrobble back to your server so listening history stays in one place.
  • Themed, browser-only setup: Pick a theme and tune sidebar options in the browser, with no account and no database on the Railway side, so settings stay with the device you use.
  • Locked server for friends: Add the optional SERVER_* variables so visitors only enter a username and password, which suits a small circle of people sharing one music server.

Dependencies for Feishin Docker hosted on Railway

This template deploys one public service with no database, no volume, and no template variables. Keep one replica.

Deployment Dependencies for Managed Feishin Service

The feishin service is public on port 8080, with no volume, no template variables, a health check at /, and restart policy Always. Keep one replica. Settings stay in the visitor browser. This is a client only; you need your own music server reachable over HTTPS with CORS.

Implementation Details for Feishin

The image ghcr.io/onepush-dev/feishin:1.17.0 is the unmodified upstream ghcr.io/jeffvli/feishin:1.17.0 web image, a static app on nginx-unprivileged. The wrapper only replaces nginx default.conf.template so nginx listens on 8080 for IPv4 and IPv6 instead of 9180, and bakes ANALYTICS_DISABLED=true so upstream analytics do not load. Optional service variables you may add are SERVER_NAME, SERVER_TYPE (navidrome, jellyfin or subsonic), SERVER_URL (must be HTTPS), SERVER_LOCK, and LEGACY_AUTHENTICATION.

How does Feishin compare against other tools

Feishin vs a desktop music player (Desktop Music Player Alternative)

  • Setup: Feishin runs in the browser on a URL you control, so family members can open it on any device without installing anything. A desktop player starts faster on one computer you already use.
  • Library access: Feishin is a client only and needs your own Navidrome, Jellyfin or Subsonic-compatible server reachable over HTTPS with CORS. A desktop player may read music files directly from disk, with no server needed.
  • Desktop extras: The upstream desktop app adds an MPV backend and built-in lyrics fetching. This Railway package is the web image only, so those extras are not included.

Feishin vs a music server built-in web UI (Server Web UI Alternative)

  • Scope: A server's own web interface is the simplest choice if you only use that one server. Feishin works with several server APIs, so you can switch servers without changing your client.
  • Features: Feishin focuses on playback, with queues, synced and unsynced lyrics, smart playlists (Navidrome), scrobbling and themes. Built-in server UIs may cover administration tasks that Feishin does not.
  • Storage: Feishin keeps settings in the visitor browser and has no database or volume here. A server's built-in UI stores its data on the server, which you back up separately.

Feishin with Docker vs Railway (Railway Alternative)

  • Control: Running the upstream Docker image yourself gives full control over the host, ports and networking. On Railway you get one service with a public domain, a health check on / and restart policy Always.
  • Maintenance: Docker on your own machine means you patch the host and update the image yourself. On Railway you still choose when to redeploy, but the platform runs the container for you.
  • Ports: The upstream image listens on 9180 by default. This template uses an unmodified upstream image behind a small wrapper that moves nginx to 8080 and bakes ANALYTICS_DISABLED=true, so it differs from a plain Docker run.

How to use Feishin on Railway?

Once the deploy finishes, use the steps below to get your first session running.

  1. Open the public domain Railway generated for the feishin service in your browser.
  2. On the "Server required" form, add the HTTPS URL of your existing music server and choose its type.
  3. Sign in with your own account on that server. Your settings and login stay in your browser, since this service has no database and no volume.
  4. To pre-set a server for everyone, add the optional SERVER_NAME, SERVER_TYPE and SERVER_URL variables to the feishin service, and set SERVER_LOCK to true if you want visitors to change only their username and password.
  5. Keep one replica for this service. The health check path is /, and the restart policy is Always.
Health check path: /
Restart policy: Always
Replicas: 1
Public port: 8080

How to self host Feishin on other VPS Services (Feishin self hosting guide)

Clone the Repository

Clone the upstream project at the v1.17.0 tag, then change into the directory.

git clone --branch v1.17.0 https://github.com/jeffvli/feishin.git
cd feishin

Install Dependencies

Install the Node.js and package tooling the upstream project documents, then install its packages from the repository root.

Configure Environment Variables

Set the optional server variables if you want a server pre-filled for visitors. Use your-domain as a stand-in for your own HTTPS music server address.

SERVER_NAME=my-music
SERVER_TYPE=navidrome
SERVER_URL=https://music.your-domain

Start the Feishin Application

Use the upstream flow: run the documented feishin web container, which listens on 9180 by default; see the upstream repository for the current commands.

Pricing and License of Feishin (Feishin pricing)

Feishin is open-source software released under the GPL-3.0 license, so you can self-host it for free.

Your costs come from the infrastructure you run it on, such as Railway usage or a VPS, plus any model or mail provider you choose to connect.

Feishin hosted vs self hosted comparison (Pricing, features, costs, and more)

This template packages the GPL-3.0 web image of Feishin. It does not include a music server or quote hosted plan prices.

Monthly cost of self hosting Feishin on Railway

Railway bills on usage, so your monthly cost depends on the RAM and CPU the service uses and on the other services in your project.

System Requirements for Hosting Feishin on a VPS

Feishin is a static web app served by nginx, so a small VPS with HTTPS is enough to host the client.

Feishin is a client only and does not include a music server. You need a Navidrome, Jellyfin, or Subsonic-compatible server that you already run, reachable over HTTPS, with CORS configured so the browser can call it. Settings stay in the visitor browser, so there is nothing on a volume to back up. ANALYTICS_DISABLED is baked true, so upstream analytics do not load unless you change that yourself. The template asks for no inputs at deploy time. Keep one replica unless you have a clear reason to change it, because local state is not shared across instances.

Frequently Asked Questions (FAQs)

Does this template include a music server?

No. This template deploys just the web player, and it will sit empty until you point it at a server you already run.

Where are my Feishin settings stored?

Settings such as theme, language, and your saved server list are stored in your browser, not on the server.

Are analytics turned on?

No. You do not need to set anything to keep tracking off.

Is this affiliated with Navidrome or Jellyfin?

No. Those names appear only to describe the server APIs the client can talk to.

What should I back up?

Nothing on a volume. This service is stateless and keeps settings in the browser.


Template Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0