Self-Host Gitea on a Raspberry Pi

Command list:

Download and run the docker installation script:

curl -fsSL -o
sudo sh

Add the current user to the “docker” group to enable commands to be run without sudo. Replace “pi” with your username if it differs. Lot out and back in to apply changes.

sudo usermod -aG docker pi
sudo su – pi

Check that docker and docker compose have been installed:

docker --version
docker compose version

Create a “docker-compose.yml” file somewhere sensible and paste in the following. Remember to change the ports if there are clashes with other services. If you already have

version: "3"

    external: false

    image: gitea/gitea:latest
    container_name: gitea
      - USER_UID=1000
      - USER_GID=1000
    restart: always
      - gitea
      - ./gitea:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
      - "3000:3000"
      - "222:22"

Save and exit your editor. If you want to start docker when your Pi boots up, then run the following command:

sudo systemctl enable docker

Now start the docker stack. Run the following command (in the directory of your docker-compose.yml file) to start the containers in the background:

docker compose up --detach

Now you can navigate to your Gitea server by pointing your web browser to the IP address of your Raspberry Pi followed by port 3000.

Leave a comment

Your email address will not be published. Required fields are marked *