forgejo/docs/content/doc/usage/backup-and-restore.en-us.md
techknowlogick fb5c6b6444 Import docs into main repository (#2874)
* import docs into main repository

Signed-off-by: Matti Ranta <matti@mdranta.net>
2017-11-26 23:44:32 +02:00

1.7 KiB

date title slug weight toc draft menu
2017-01-01T16:00:00+02:00 Usage: Backup and Restore backup-and-restore 11 true false
sidebar
parent name weight identifier
usage Backup and Restore 11 backup-and-restore

Backup and Restore

Gitea currently has a dump command that will save your installation to a zip file. There will be a restore command implemented at some point in the future. You will be able to use this to back up your installation, as well as make migrating servers easier.

Backup Command (dump)

First, switch to the user running gitea: su git (or whatever user you are using). Run ./gitea dump in the gitea installation directory. You should see some output similar to this:

2016/12/27 22:32:09 Creating tmp work dir: /tmp/gitea-dump-417443001
2016/12/27 22:32:09 Dumping local repositories.../home/git/gitea-repositories
2016/12/27 22:32:22 Dumping database...
2016/12/27 22:32:22 Packing dump files...
2016/12/27 22:32:34 Removing tmp work dir: /tmp/gitea-dump-417443001
2016/12/27 22:32:34 Finish dumping in file gitea-dump-1482906742.zip

Inside the gitea-dump-1482906742.zip file, you will find the following:

  • custom/conf/app.ini - This is your server config.
  • gitea-db.sql - SQL dump of your database.
  • gitea-repo.zip - This zip will be a complete copy of your repo folder. See Config -> repository -> ROOT for the location.
  • log/ - this will contain various logs. You don't need these if you are doing a migration.

Intermediate backup files are created in a temporary directory specified either with the --tempdir command-line parameter or the TMPDIR environment variable.

Restore Command (restore)

WIP: Does not exist yet.