Release Date: March 7, 2026
AudioMuse-AI v0.8.13 release introduces an optional authentication layer designed to better protect both the integrated frontend and external integrations such as plugins.
New Authentication Layer
AudioMuse-AI can now restrict access using:
- Username and password for the integrated frontend
- API tokens for external server-to-server applications (such as plugins)
This allows safer integration with media servers and other automated tools while also protecting the user interface.
You can find here the AUTHENTICATION documentation.
Disabled by Default
To avoid breaking existing deployments, authentication is disabled by default.
To enable it, set the following environment variables:
AUDIOMUSE_USER
AUDIOMUSE_PASSWORD
API_TOKEN
Important: Authentication is enabled only if all three variables are set and contain non-empty values.
If even one of them is missing or empty, the authentication layer will remain disabled.
HTTPS Requirement
For the authentication system to be secure, AudioMuse-AI must be deployed over HTTPS.
HTTPS configuration is not handled automatically, since it depends on your infrastructure (reverse proxy, container setup, hosting environment, etc.).
Recommended Production Setup
While this built-in authentication provides a convenient solution, the recommended secure deployment is still:
- HTTPS
- Reverse proxy
- Identity Provider (IDP) such as Authentik (or similar)
Recommended architecture:
- Protect the frontend with an IDP through the reverse proxy
- Keep server-to-server integrations inside the same private network
- Avoid exposing backend integrations directly to the internet
The new authentication layer is mainly intended as a simpler alternative for less experienced users who want basic protection without deploying a full identity management system.
Plugin Support
- ✅ Jellyfin plugin already support the api token.
- 🚧 Navidrome plugin is currently work in progress
What's Changed
- Add optional JWT + ****** authentication layer by @Copilot in #355
Full Changelog: 0.8.12...v0.8.13