How to get music in?

[james]

Hello @jdaviescoates

Please try to use:

export MEDIA_ROOT="/media/Music"

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

[joseph]

@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

[jdaviescoates]

@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.

[rmdes]

@jdaviescoates you should mount the volume at /app/data/music in Cloudron's Storage settings instead of /media/Music.

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

[rmdes]

Another way to import music fast :

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.

[jdaviescoates]

@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...

[joseph]

Looking at the repo, there are three paths:

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

[james]

According to the documentation of Funkwhale:

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"

[joseph]

thanks @james. ok, so MEDIA_ROOT is like metadata and MUSIC_DIRECTORY_PATH is the real music. .

[james]

@joseph
As I understood it, not even that.
MEDIA_ROOT is where all media uploaded gets stored.
MUSIC_DIRECTORY_PATH is like an import folder where you can manually upload files that then get imported.
But I am not 100 % certain, it is still confusing for me.