[doc] ./gitea dump doesn&#39;t allows to specify backup destination #1025

@lafriks commented on GitHub (Aug 31, 2017):

I think WIP PR #1637 will implement this?

@lafriks commented on GitHub (Aug 31, 2017): I think WIP PR #1637 will implement this?

GiteaMirror commented

@vizcay commented on GitHub (Aug 31, 2017):

@lafriks Not exactly:

   --config FILE, -c FILE   Custom configuration FILE path (default: "custom/conf/app.ini")
   --tempdir PATH, -t PATH  Temporary directory PATH (default: "/tmp")
   --target PATH            Target directory PATH to save backup archive (default: "./")
   --verbose, -v            Show process details
   --db                     Backup the database (default: true)
   --repos                  Backup repositories (default: true)
   --data                   Backup attachments and avatars (default: true)
   --custom                 Backup custom files (default: true)

--target will allow to specify where to land the zip, but still no luck to set the filename.

@vizcay commented on GitHub (Aug 31, 2017): @lafriks Not exactly: ```OPTIONS: --config FILE, -c FILE Custom configuration FILE path (default: "custom/conf/app.ini") --tempdir PATH, -t PATH Temporary directory PATH (default: "/tmp") --target PATH Target directory PATH to save backup archive (default: "./") --verbose, -v Show process details --db Backup the database (default: true) --repos Backup repositories (default: true) --data Backup attachments and avatars (default: true) --custom Backup custom files (default: true) ``` **--target** will allow to specify where to land the zip, but still no luck to set the filename.

GiteaMirror commented

@bkcsoft commented on GitHub (Sep 4, 2017):

Should be easy enough to change --target to take a filename instead of a directory :)

@bkcsoft commented on GitHub (Sep 4, 2017): Should be easy enough to change `--target` to take a filename instead of a directory :)

GiteaMirror commented

@jabouchleih commented on GitHub (Feb 13, 2018):

Was this functionality removed?

OPTIONS:
--config value, -c value Custom configuration file path (default: "custom/conf/app.ini")
--verbose, -v Show process details
--tempdir value, -t value Temporary dir path (default: "/tmp")
--database value, -d value Specify the database SQL syntax

@jabouchleih commented on GitHub (Feb 13, 2018): Was this functionality removed? > OPTIONS: > --config value, -c value Custom configuration file path (default: "custom/conf/app.ini") > --verbose, -v Show process details > --tempdir value, -t value Temporary dir path (default: "/tmp") > --database value, -d value Specify the database SQL syntax

GiteaMirror commented

@vizcay commented on GitHub (Feb 14, 2018):

@Quinity to be honest IDK, I ended using awk to extract the dump filename but a --target or something similar will be much more appreciated.

@vizcay commented on GitHub (Feb 14, 2018): @Quinity to be honest IDK, I ended using awk to extract the dump filename but a --target or something similar will be much more appreciated.

GiteaMirror commented

@The-King-of-Toasters commented on GitHub (Jun 21, 2018):

I recently tried tackling this using cron on my debian machine, but I had no luck. However, I found great sucess using a systemd service/timer and setting the WorkingDirectory to wherever you like.

The service file:

[Unit]
Description=Gitea Dump

[Service]
Type=simple
User=git
Group=git
WorkingDirectory=/var/gitea/backup
ExecStart=/usr/local/bin/gitea dump -c /etc/gitea/app.ini
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea

[Install]
WantedBy=multi-user.target

Timer:

[Unit]
Description=Daily Gitea Dump

[Timer]
# See systemd.time(7) for time format
OnCalendar=*-*-* 05:00:00
Persistent=true

[Install]
WantedBy=timers.target

And the output of /var/gitea/backup:

$ ls /var/gitea/backup
gitea-dump-1529562686.zip

@The-King-of-Toasters commented on GitHub (Jun 21, 2018): I recently tried tackling this using cron on my debian machine, but I had no luck. However, I found great sucess using a systemd service/timer and setting the `WorkingDirectory` to wherever you like. The service file: ```ini [Unit] Description=Gitea Dump [Service] Type=simple User=git Group=git WorkingDirectory=/var/gitea/backup ExecStart=/usr/local/bin/gitea dump -c /etc/gitea/app.ini Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea [Install] WantedBy=multi-user.target ``` Timer: ```ini [Unit] Description=Daily Gitea Dump [Timer] # See systemd.time(7) for time format OnCalendar=*-*-* 05:00:00 Persistent=true [Install] WantedBy=timers.target ``` And the output of `/var/gitea/backup`: ```sh $ ls /var/gitea/backup gitea-dump-1529562686.zip ```

GiteaMirror commented

@stale[bot] commented on GitHub (Jan 22, 2019):

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs during the next 2 weeks. Thank you for your contributions.

@stale[bot] commented on GitHub (Jan 22, 2019): This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs during the next 2 weeks. Thank you for your contributions.

GiteaMirror commented

@nodiscc commented on GitHub (Nov 20, 2019):

--target is not documented in https://docs.gitea.io/en-us/backup-and-restore/

@nodiscc commented on GitHub (Nov 20, 2019): `--target` is not documented in https://docs.gitea.io/en-us/backup-and-restore/

GiteaMirror commented

@lunny commented on GitHub (Nov 21, 2019):

So this is a documentation problem not a feature.

@lunny commented on GitHub (Nov 21, 2019): So this is a documentation problem not a feature.

GiteaMirror commented

@AllTaken commented on GitHub (Nov 21, 2019):

I don't know. Does --target allow you to specify the filename now? That was the original feature request as I understand it. At least that's what I would want for my use-case.

@AllTaken commented on GitHub (Nov 21, 2019): I don't know. Does --target allow you to specify the filename now? That was the original feature request as I understand it. At least that's what I would want for my use-case.

GiteaMirror commented

@nodiscc commented on GitHub (Nov 26, 2019):

@lunny I was just mentioning the missing documentation, in addition to the feature request discussed here - I think it's a good opportunity to fix the documentation. I don't think --target accepts a destination filename (only a directory).

I would appreciate this change, because I run dumps from a cron job and the destination directory ends up cluttered with daily dumps.

But maybe some people prefer the old behavior - in this case there could be 2 separate options (--destdir --destfile), or we could just resort to --destfile /var/backups/gitea/gitea-dump-$(date +%s)

@nodiscc commented on GitHub (Nov 26, 2019): @lunny I was just mentioning the missing documentation, in addition to the feature request discussed here - I think it's a good opportunity to fix the documentation. I don't think `--target` accepts a destination filename (only a directory). I would appreciate this change, because I run dumps from a cron job and the destination directory ends up cluttered with daily dumps. But maybe some people prefer the old behavior - in this case there could be 2 separate options (`--destdir` `--destfile`), or we could just resort to `--destfile /var/backups/gitea/gitea-dump-$(date +%s)`

GiteaMirror commented

@AllTaken commented on GitHub (Jan 23, 2020):

So it looks like this has been implemented with:
--file name, -f name: Name of the dump file with will be created. Optional. (default: gitea-dump-[timestamp].zip).

I guess you can close this issue?
And to anyone else using the AWK trick from above: that doesn't work anymore.

@AllTaken commented on GitHub (Jan 23, 2020): So it looks like this has been implemented with: --file name, -f name: Name of the dump file with will be created. Optional. (default: gitea-dump-[timestamp].zip). I guess you can close this issue? And to anyone else using the AWK trick from above: that doesn't work anymore.

GiteaMirror commented

@julian-poidevin commented on GitHub (May 19, 2020):

--target is not documented in https://docs.gitea.io/en-us/backup-and-restore/

This is not yet documented

@julian-poidevin commented on GitHub (May 19, 2020): > `--target` is not documented in https://docs.gitea.io/en-us/backup-and-restore/ This is not yet documented

GiteaMirror commented

@nodiscc commented on GitHub (Jun 1, 2020):

--work-dir is also not documented (https://github.com/go-gitea/gitea/issues/9100)

@nodiscc commented on GitHub (Jun 1, 2020): `--work-dir` is also not documented (https://github.com/go-gitea/gitea/issues/9100)

GiteaMirror commented

@6543 commented on GitHub (Sep 7, 2020):

it's implemented option: --file/-f

@6543 commented on GitHub (Sep 7, 2020): it's implemented option: `--file/-f`

GiteaMirror commented

@6543 commented on GitHub (Sep 7, 2020):

and if you type gitea dump --help you get the whole documentation of this subcomand

@6543 commented on GitHub (Sep 7, 2020): and if you type `gitea dump --help` you get the whole documentation of this subcomand

GiteaMirror commented

@nodiscc commented on GitHub (Sep 12, 2020):

@6543 yes but the documentation is wrong https://docs.gitea.io/en-us/command-line/#dump

Just copy pasting the gitea dump --help output there would be better than having outdated documentation. Do you want me to send a pull request?

@nodiscc commented on GitHub (Sep 12, 2020): @6543 yes but the documentation is wrong https://docs.gitea.io/en-us/command-line/#dump Just copy pasting the `gitea dump --help` output there would be better than having outdated documentation. Do you want me to send a pull request?

GiteaMirror commented