Skip to main content

Funkwhale

Funkwhale is available in the NetActuate Marketplace as a one-click, open-source appliance you can deploy into any NetActuate PoP. Self-hosted, federated music streaming with a web player and Subsonic apps. It is grouped under the Media & Streaming category.

What It Does​

Funkwhale is a self-hosted audio and music streaming server. Upload your music and audio, organize it into libraries, channels and playlists, and stream it from a modern web player or any Subsonic-compatible mobile and desktop app. Funkwhale also speaks ActivityPub, so instances can federate: you can follow and share libraries and channels across the fediverse. It is completely free software.

Deployed from the NetActuate marketplace it boots ready on Ubuntu 24.04 LTS from the official public Funkwhale containers (funkwhale/api and funkwhale/front) with PostgreSQL and Redis, wired together by docker-compose. There is no license and no key: a superuser account is created at first boot from the username and email you seed and a password the platform generates for you. The web UI, the REST API and the Subsonic-compatible API are served on port 80.

Upstream project: Funkwhale (https://funkwhale.audio, source at https://dev.funkwhale.audio/funkwhale/funkwhale), an independent open source project released under the GNU AGPLv3 by the Funkwhale collective. Funkwhale is not affiliated with or endorsed by NetActuate; NetActuate packages the unmodified upstream 1.4.0 release containers.

Vendor and Project​

Funkwhale is an open-source project, offered here under the Open Source listing with best-effort community support.

NetActuate supports the underlying infrastructure. Application-level support follows the listing SLA class (open-source, best effort).

Sizing​

vCPURAMDisk
Minimum24 GB25 GB
Recommended48 GB50 GB

No VPU (hardware acceleration) is required for this appliance. Choose a size at deploy based on your expected load.

Configuration Fields​

When you deploy, you provide these fields. They are written into the appliance at first boot.

FieldRequiredDefaultNotes
Admin emailNoadmin@example.comEmail address associated with the superuser account. Default admin@example.com.
Admin passwordNogeneratedPassword for the first-boot superuser. Generated for you and placed in your deployment's secret list; sign in with it at the web UI. Stored write-only in your account secret list
Admin usernameNoadminLogin for the superuser account created at first boot. Default admin.
Public hostnameNononeOptional public hostname for this instance (used for federation and URLs; cannot be changed after deploy). Leave empty to use the VM's public IPv4.

Using the Appliance​

Funkwhale is up. Open the web UI at http://YOUR_VM_IP/ and sign in as the superuser created at first boot: the username and email you seeded, with the generated admin password from your deployment's secret list. No license or key is required (Funkwhale is free software, AGPLv3). Stream from the web player or any Subsonic-compatible app. Exposure posture: port 80 serves the web UI and API over plain HTTP; before exposing it to the public internet, put a TLS-terminating proxy in front or restrict access to trusted source IPs.

FAQ​

Is there a software license fee? No. Funkwhale is open source and free to run. You pay only for the NetActuate infrastructure and bandwidth.

Which port does the appliance serve on? The primary service is published on port 80 by default; see the configuration fields for any adjustable ports.

Who supports it? NetActuate operates the underlying infrastructure. The application itself is community-supported open source (best-effort SLA class).

Version and Changelog​

VersionStatusReleased
1.4.0Current (default)2026-07-11

Deploy​

Need Help?​

Contact support@netactuate.com or open a support ticket from the portal.