Manual backup wrong filename

[rizlas]

Describe the bug

When triggering a manual backup, the backup is executed correctly, but the file naming is wrong and does not respect what is defined in the configuration file (BACKUP_FILENAME env var). In the backup filename prefix, only backup-%Y-%m-%dT%H-%M-%S.{{ .Extension }} is used instead of the expected mybestbackup-%Y-%m-%dT%H-%M-%S.{{ .Extension }}.

To Reproduce

Steps to reproduce the behavior:

1. Configure the backup prefix in the configuration file asmybestbackup-%Y-%m-%dT%H-%M-%S.{{ .Extension }}.
2. Trigger a manual backup as described in the documentation.
3. Check the generated backup filename.

Expected behavior

The generated backup filename should use the prefix configured in the file (e.g., mybestbackup-...) instead of the default backup-....

Version (please complete the following information):

Image Version: v2
Docker Version: 28.3.3
Docker Compose Version (if applicable): 2.39.1

Additional context

If this behavior is intentional, it is not specified in the documentation:
https://offen.github.io/docker-volume-backup/how-tos/manual-trigger.html

[m90]

It's not really possible for this tool to pick up only parts of the given configuration, while other parts are ignored, no matter if it's running on a cron schedule or being invoked manually. As you describe it, there must be something in your setup that makes you pass different configuration values than you expect.

To further debug this: how do you configure the backup when running on the cron schedule (giving you the desired filename pattern) and how do you configure the backup when invoking it manually (ending up with the default filename pattern)? Also, how exactly do you invoke the one-off backup?

[rizlas]

Sorry for the useless issue. The BACKUP_FILENAME environment variable was missing quotes, and that was what caused the problem when the env file was loaded.

Scheduled backup

time=2025-08-22T14:24:00.027+02:00 level=INFO msg="Now running script on schedule * * * * *"
time=2025-08-22T14:24:00.029+02:00 level=INFO msg="Created backup of `/backup/my-data-volumes` at `/tmp/my-data-volumes-2025-08-22T14-24-00.tar.gz`."
time=2025-08-22T14:24:00.041+02:00 level=INFO msg="Encrypted backup using \"gpg\", saving as \"/tmp/my-data-volumes-2025-08-22T14-24-00.tar.gz.gpg\""
time=2025-08-22T14:24:00.041+02:00 level=INFO msg="Stored copy of backup `/tmp/my-data-volumes-2025-08-22T14-24-00.tar.gz.gpg` in `/archive/my-data-volumes`." storage=Local
time=2025-08-22T14:24:00.326+02:00 level=INFO msg="Uploaded a copy of backup `/tmp/my-data-volumes-2025-08-22T14-24-00.tar.gz.gpg` to bucket `docker-volume-backup`." storage=S3
time=2025-08-22T14:24:00.326+02:00 level=INFO msg="None of 4 existing backups were pruned." storage=Local
time=2025-08-22T14:24:00.382+02:00 level=INFO msg="None of 4 existing backups were pruned." storage=S3
time=2025-08-22T14:24:00.382+02:00 level=INFO msg="Removed tar file `/tmp/my-data-volumes-2025-08-22T14-24-00.tar.gz`."
time=2025-08-22T14:24:00.382+02:00 level=INFO msg="Removed encrypted file `/tmp/my-data-volumes-2025-08-22T14-24-00.tar.gz.gpg`."

Manual backup

BACKUP_FILENAME=my-data-volumes-%Y-%m-%dT%H-%M-%S.{{ .Extension }}
docker exec docker-volume-backup /bin/sh -c 'set -a; source /etc/dockervolumebackup/conf.d/my-data-volumes.env; set +a && backup'

/bin/sh: /etc/dockervolumebackup/conf.d/my-data-volumes.env: line 4: .Extension: not found

time=2025-08-22T14:24:15.519+02:00 level=INFO msg="Created backup of `/backup/my-data-volumes` at `/tmp/backup-2025-08-22T14-24-15.tar.gz`."
time=2025-08-22T14:24:15.533+02:00 level=INFO msg="Encrypted backup using \"gpg\", saving as \"/tmp/backup-2025-08-22T14-24-15.tar.gz.gpg\""
time=2025-08-22T14:24:15.533+02:00 level=INFO msg="Stored copy of backup `/tmp/backup-2025-08-22T14-24-15.tar.gz.gpg` in `/archive/my-data-volumes`." storage=Local
time=2025-08-22T14:24:15.770+02:00 level=INFO msg="Uploaded a copy of backup `/tmp/backup-2025-08-22T14-24-15.tar.gz.gpg` to bucket `docker-volume-backup`." storage=S3
time=2025-08-22T14:24:15.770+02:00 level=INFO msg="None of 5 existing backups were pruned." storage=Local
time=2025-08-22T14:24:15.821+02:00 level=INFO msg="None of 5 existing backups were pruned." storage=S3
time=2025-08-22T14:24:15.821+02:00 level=INFO msg="Removed tar file `/tmp/backup-2025-08-22T14-24-15.tar.gz`."
time=2025-08-22T14:24:15.821+02:00 level=INFO msg="Removed encrypted file `/tmp/backup-2025-08-22T14-24-15.tar.gz.gpg`."

Manual backup and backup_filename with quotes

BACKUP_FILENAME="my-data-volumes-%Y-%m-%dT%H-%M-%S.{{ .Extension }}"
docker exec docker-volume-backup /bin/sh -c 'set -a; source /etc/dockervolumebackup/conf.d/my-data-volumes.env; set +a && backup'

time=2025-08-22T14:28:08.864+02:00 level=INFO msg="Created backup of `/backup/my-data-volumes` at `/tmp/my-data-volumes-2025-08-22T14-28-08.tar.gz`."
time=2025-08-22T14:28:08.876+02:00 level=INFO msg="Encrypted backup using \"gpg\", saving as \"/tmp/my-data-volumes-2025-08-22T14-28-08.tar.gz.gpg\""
time=2025-08-22T14:28:08.876+02:00 level=INFO msg="Stored copy of backup `/tmp/my-data-volumes-2025-08-22T14-28-08.tar.gz.gpg` in `/archive/my-data-volumes`." storage=Local
time=2025-08-22T14:28:09.116+02:00 level=INFO msg="Uploaded a copy of backup `/tmp/my-data-volumes-2025-08-22T14-28-08.tar.gz.gpg` to bucket `docker-volume-backup`." storage=S3
time=2025-08-22T14:28:09.116+02:00 level=INFO msg="None of 9 existing backups were pruned." storage=Local
time=2025-08-22T14:28:09.169+02:00 level=INFO msg="None of 9 existing backups were pruned." storage=S3
time=2025-08-22T14:28:09.169+02:00 level=INFO msg="Removed tar file `/tmp/my-data-volumes-2025-08-22T14-28-08.tar.gz`."
time=2025-08-22T14:28:09.169+02:00 level=INFO msg="Removed encrypted file `/tmp/my-data-volumes-2025-08-22T14-28-08.tar.gz.gpg`."

[m90]

No worries, glad you got it solved.