Instantly share code, notes, and snippets.

What would you like to do?
Installing Gitea on Raspberry Pi 3 b+ with nginx and automatic backups

Setup Gitea on Raspberry Pi (3b+)

These instructions are based on this article:

Other instructions.

Setup Raspberry Pi with minimal Raspbian image. You need to connect to the HDMI port and set the following:

Use Noobs to install Raspian.

Open menu Preferences > Raspberry Pi Settings

There you need to enable the SSH server and you should change the hostname.

Then configure the correct timezone:

Now log in via ssh and execute the following commands:

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install zip git -y

Install nginx

# Might need to update sources.list if nginx package isn't found.
sudo pico /etc/apt/sources.list
# uncomment last line
sudo apt-get update

sudo apt-get install nginx -y

Create a new user:

sudo adduser --disabled-login --gecos 'Gitea' git

Install latest release of Go

git clone
cd update-golang
sudo ./

Updating version of Go

From the pi user issue the following command. sudo ./

Then you will need to rebuild Gitea to use the updated version of Go.

Change to user git:

sudo su - git

Set environment variables

You will eventually need to add these environmental variables to each user pi, git, root

export PATH=$PATH:/usr/local/go/bin
export GOPATH=/home/git
export PATH=$PATH:$GOPATH/bin
export PATH=$PATH:$GOPATH/src/
export PATH=$PATH:$GOPATH/src/

Download go-bindata

go get

Download the latest gitea version:

go get -d -u

Now type exit to go back to pi user

Build it under root user

sudo su - root

Reset environment variables above with root user

cd $GOPATH/src/
TAGS="bindata sqlite" make generate build

Now type exit to go back to pi user.

Configure Gitea and Nginx

Create/Edit /etc/systemd/system/gitea.service and add the following content:

After=mariadb.service mysqld.service postgresql.service memcached.service redis.service

# Modify these two values and uncomment them if you have
# repos with lots of files and get an HTTP error 500 because
# of that
ExecStart=/home/git/src/ web
Environment=USER=git HOME=/home/git

# Start gitea:
sudo systemctl enable gitea
sudo systemctl start gitea

Create/Edit /etc/nginx/sites-available/gitea and insert the following:

server {
    listen 80;
    server_name gitea;
    location / {
        client_max_body_size 364M;
        proxy_pass http://localhost:3000;
        proxy_connect_timeout 600;
        proxy_send_timeout 600;
        proxy_read_timeout 600;
        send_timeout 600;
        proxy_set_header X-Real-IP $remote_addr;

Then enable the gitea nginx-site and restart the nginx server:

sudo ln -s /etc/nginx/sites-available/gitea /etc/nginx/sites-enabled/gitea
sudo service nginx restart

Update Gitea

sudo su - git

# Load environmental variables to $PATH as above

cd $GOPATH/src/
git checkout <branch>
go get -d -u
sudo su - root

# Load environmental variables to $PATH as above

cd $GOPATH/src/
TAGS="bindata sqlite" make generate build
sudo systemctl restart gitea

Create backup-script

Now we want to create a backup script that is run by crontab every day. To do so, create a new file called and insert the following content (replace YOUR_SERVER/YOUR/DIR as well as USER and PASSWORD):


# Create directory if it does not exist
mkdir -p git

# Mount NAS directory
sudo mount -t cifs //<your-nas>/Git git -o user=<your-nas-user>,pass=<your-password>

# Create backup directory if it does not exist and cd into it
mkdir -p git/gitea-backups

# Run the backup job
sudo zip -r "git/gitea-backups/gitea-backup-$(date +"%Y-%m-%d %H-%M-%S").zip" /home/git/src/ /home/git/src/ /home/git/gitea-repositories

# Remove all files, keeping the last recent one and cd back
cd git/gitea-backups
ls -t1 . | tail -n +3 | xargs -d '\n' rm -f
cd ../..

# Allow changing the backup dir and files
sudo chmod -R 777 git/gitea-backups

# Clean up everything
sudo umount git
rmdir git

Now chmod +x and create a new crontab entry:

crontab -e

# Now add the following line:
0 0 * * * /home/pi/

This calls our script everyday at 0:00 AM, creates a gogs dump and copies it to our network share.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment