---
title: "Deploy Funkwhale"
description: "Federated music server — stream your library, playlists, podcasts."
category: "Storage"
url: https://railway.com/deploy/funkwhale
---

# Deploy Funkwhale

Federated music server — stream your library, playlists, podcasts.

**[Deploy Funkwhale on Railway](https://railway.com/template/funkwhale)**

- **Creator:** Two Workspaces
- **Category:** Storage
- **Total deploys:** 3

## Template content

### redis https://media.ffycdn.net/us/redis/MAQLWqeBKmrz2TFQDmA7.svg?mod=v1/resize=2400

- **Image:** redis:7-alpine
- **Start command:** `docker-entrypoint.sh redis-server --save '' --appendonly no`

### postgres https://www.postgresql.org/media/img/about/press/elephant.png

- **Image:** postgres:17-alpine

### funkwhale https://docs.funkwhale.audio/_static/logo.svg

- **Source:** https://github.com/nomideusz/funkwhale-railway
- **Health check:** /
- **Public domain:** Yes

## Documentation

# Deploy and Host Funkwhale on Railway

[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/new/template/funkwhale?utm_medium=integration&utm_source=button&utm_campaign=funkwhale)

[Funkwhale](https://funkwhale.audio/) is a self-hosted, federated audio platform: upload your music library, stream it from any device (web, Subsonic apps), create playlists and radios, publish podcasts and channels, and optionally federate with other Funkwhale pods over ActivityPub.

## Screenshots

![Funkwhale album browsing](https://raw.githubusercontent.com/nomideusz/funkwhale-railway/main/images/01.jpg)

## About Hosting Funkwhale

This template runs Funkwhale as three Railway services. The main service is a combined container (Django API via gunicorn, celery worker with beat for imports and federation, and nginx serving the web frontend and media) — one container, one volume, no shared-storage juggling. PostgreSQL and Redis run as separate services. On first boot it runs migrations, collects static files, and creates your admin account from the `FUNKWHALE_ADMIN_PASSWORD` variable (username `fwadmin`). Music, media, and static files persist on the volume at `/srv/funkwhale/data`.

## Common Use Cases

- Personal music streaming server for your own library (Subsonic API compatible apps work)
- Community/label pod with user accounts, channels, and podcasts
- Federated audio publishing connected to the Fediverse

## Dependencies for Funkwhale Hosting

- All bundled: PostgreSQL 17 and Redis are provisioned by the template

### Deployment Dependencies

- [Funkwhale documentation](https://docs.funkwhale.audio/)
- [Template source on GitHub](https://github.com/nomideusz/funkwhale-railway)

### Implementation Details

**Your pod is the `funkwhale` service's Railway domain.** Log in with username `fwadmin` and the `FUNKWHALE_ADMIN_PASSWORD` variable's value (auto-generated — find it in the service's variables).

Notes and limits:

- Upload music via the web UI (Libraries) or any Subsonic-compatible client; server-side in-place import is also available under `/srv/funkwhale/data/music`.
- Media lives on the service volume; volume size is plan-dependent on Railway — check your plan's cap against your library size.
- Redis is intentionally ephemeral: a restart loses only queued-but-unstarted import/federation jobs.
- Upload body size is capped at 500 MB per request by default (`NGINX_MAX_BODY_SIZE` variable).
- Funkwhale rejects a few reserved admin usernames (`admin`, `root`, …) — that's why the default is `fwadmin`; override with `FUNKWHALE_ADMIN_USERNAME`.
- If you attach a custom domain later, update `FUNKWHALE_HOSTNAME` **before** federating — the hostname is your pod's federated identity.

## Why Deploy Funkwhale 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 Funkwhale 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.


## Similar templates

- [Garage S3 Storage](https://railway.com/deploy/garage-s3-storage) — Ultra-light S3 server: fast, open-source, plug-and-play.
- [Redis](https://railway.com/deploy/redis-1) — Self Host Latest Redis with Railway
- [EasyImg](https://railway.com/deploy/easyimg) — Simple self-hostable Nuxt.js personal image hosting system.

Open this page in a browser: https://railway.com/deploy/funkwhale