#5147·dokploy

[Feature Request] Show usage example for File Mounts created in the UI

Author: jk779Created Aug 21, 2026Updated Sep 17, 2026
Labelsenhancement

What problem will this feature address?

When creating a File Mount in the Advanced-UI, the file is stored in the services files directory. However, the UI does not show how this file should be referenced from a custom docker-compose.yml.

For example, after creating a File Mount named Caddyfile, it is not obvious that the compose entry needs to reference:

../files/Caddyfile:/etc/caddy/Caddyfile

instead of:

./Caddyfile:/etc/caddy/Caddyfile

Describe the solution you'd like

A small hint in the File Mount dialog showing the generated path and an example volume entry would make this feature much easier to discover.

Something like:

File location:
../files/Caddyfile

docker-compose example:
../files/Caddyfile:/etc/caddy/Caddyfile

would likely prevent confusion, especially since the normal Docker Compose pattern is to use relative paths from the compose file directory.

Describe alternatives you've considered

The docs clearly state that you have to use ../files/<FILENAME>, though I think it should not be necessary to read through the docs when a usage hint would clear things up immediately.

Additional context

Thanks for developing Dokploy! I really like it :)