MEDIA_ROOT

The path where you store media files (such as album covers or audio tracks) on your system. Make sure this directory actually exists.

MUSIC_DIRECTORY_PATH

The path on your server where Funkwhale places files from in-place imports. This path needs to be readable by the webserver and api and worker processes.

MUSIC_DIRECTORY_SERVE_PATH

On Docker setups the value of MUSIC_DIRECTORY_PATH may be different from the actual path on your server. You can specify this path in your docker-compose.yml file

When setting this in the /app/data/env.sh and creating the folders and setting the correct permissions manually.
A media file was uploaded to the volume.

export MEDIA_ROOT="/media/External SSD/funkwhale/media"
export STATIC_ROOT="/media/External SSD/funkwhale/static"
export MUSIC_DIRECTORY_PATH="/media/External SSD/funkwhale/music"
export MUSIC_DIRECTORY_SERVE_PATH="/media/External SSD/funkwhale/music"

export MEDIA_ROOT="/app/data/media"
export MUSIC_DIRECTORY_PATH="/app/data/music"
export MUSIC_DIRECTORY_SERVE_PATH="/app/data/music"

What's the difference between music and media cc @james

@rmdes said:

So the key point for the user: mount at /app/data/music

But unless I've misunderstood Cloudron Volumes cannot be mounted there, they are always at /media/volume-name , no?

Perhaps it's possible to symlink or something?

But, I think if I set MUSIC_DIRECTORY_PATH to (in my case) /media/Music I'd guess it would've worked... will have another play...

In-place import means Funkwhale indexes your music files without copying them — it reads the metadata (tags) and creates database entries, then streams directly from the original location.

In the Cloudron context, it would work like this:

1. Mount the volume at /app/data/music in Cloudron's Storage settings
2. Files are immediately visible to Funkwhale - MUSIC_DIRECTORY_PATH already points there
3. Import via CLI from the web terminal:

/app/code/manage.sh import_files <library_id> "/app/data/music/" --in-place --recursive

3. (Get your library ID from the Funkwhale web UI, create a library first if you haven't)
4. Streaming works because nginx already serves /_protected/music/ from /app/data/music/ via X-Accel-Redirect, the files are served directly, no duplication

The package even has scheduler tasks for maintaining in-place imports:

• check_inplace_files_check - dry-run to see if any referenced files are missing
• check_inplace_files_apply - actually update the database for missing files

So the key point for the user: mount at /app/data/music, then in-place import just works out of the box. Their files stay on the mounted volume, Funkwhale only stores metadata in PostgreSQL, and nginx serves the audio directly from disk.

The package already expects music files at /app/data/music/, nginx already serves from there, and the env vars already point there. No env.sh changes needed, just change the mount point in Cloudron's UI.

I have not tested with a volume mount (I'm still loading all my collection within /app/data/music natively in the container, but I will transition to volume mount soon

@james said:

Hello @jdaviescoates

Please try to use:

export MEDIA_ROOT="/media/Music"

in the /app/data/env.sh file.

That didn't seem to make any difference. Any my server is running out of space so for now I've just deleted the app to free app a little.

@jdaviescoates said:

PS I thought we normally had env instead of env.sh in Cloudron apps these days?

env.sh -> export required
env -> no export required

Please try to use:

export MEDIA_ROOT="/media/Music"

in the /app/data/env.sh file.