---
title: Upgrading Gitea
description: 
published: true
date: 2022-04-30T20:10:44.240Z
tags: git, backup, docker, linux, restore, upgrade
editor: markdown
dateCreated: 2022-01-31T18:03:38.387Z
---

Upgrading Gitea can involve migrating the Postgresql settings, which must be done carefully. It consists of two phases - the export, which is done via the Gitea server, and the import - which is done partly through the server and partly through the database.

# Export
Gitea has a built in `dump` utility - executing the following will dump a `.zip` file into your current directory:

`docker exec -u git -w /data $(docker ps -qf "name=gitea_server") sh -c '/app/gitea/gitea dump -c /data/gitea/conf/app.ini'`

This will generate a zipped dump file:
```bash
Takahe:/Red-Vol/Media/Containers/gitea # ll /Red-Vol/Media/Containers/gitea/*.zip
-rw------- 1 shmick 1000 355487720 Jan 31 20:01 /Red-Vol/Media/Containers/gitea/gitea-dump-1643652088.zip
```

Now, this zip will consist of the server directories, and a `.sql` dump to restore to the database.


# Import

## Server

The dump is simply the contents of the `/data` directory, wherever it is mapped.

Simply move it where it should be and `chown` it to your user:

`Takahe:/Red-Vol/Media/Containers/gitea # chown -R shmick data/`

## Database

Inside the dumped archive you will find an SQL file:

```bash
Takahe:/Red-Vol/Media/Containers/gitea/postgresql # ll *.sql
-rw------- 1 70 root 775806 Jan 31 20:01 gitea-db.sql
```

In order to restore it, you must first bring up the database on the new container after updating the image. Then, move it to the database's mapped directory on the host.

Then, `exec` into the container:
`docker exec -ti gitea_db /bin/bash`

Finally, restore using the `psql` command:
`psql -U $USER -d $DATABASE < gitea-db.sql`

Finally, exit the container, bring the stack down with `docker-compose down` and recreate with `docker-compose up -d`.


Enjoy your new blazing fast Gitea!