How do I self-host gitea?

gitea can be deployed using Docker Compose. The AltStack provides a production-ready configuration that you can deploy on your own server. Simply copy the configuration and run it on any machine with Docker installed.

Is gitea free to self-host?

Yes, gitea is open source under the MIT and free to self-host. Your only costs are the server infrastructure. A basic cloud VPS starts at around $5-10/month.

What programming language is gitea built with?

gitea is built with Go. It has 58,483 stars on GitHub, indicating strong community adoption and support.

Back to Self-Hosted Stacks

Deploy gitea

Self-hosted Git service with code review, team collaboration, package registry, and CI/CD, written in Go. Provides a lightweight, all-in-one software development platform.

Quick Start

Create a directory

mkdir gitea-self-hosted && cd gitea-self-hosted

Create config file

Copy the content from the Config tab below into a file named docker-compose.yml

Deploy

docker compose up -d

Fast Track

Deploy gitea in Minutes

Use our optimized Docker templates to deploy gitea on any cloud provider. Get $200 in free credit to start on DigitalOcean.

Start with free creditDeploy on DigitalOcean

$200

Metadata

License

MIT

Language

Last Updated

10/14/2026

Configuration

yaml



# -------------------------------------------------------------------------
# 🚀 Created and distributed by The AltStack
# 🌍 https://thealtstack.com
# -------------------------------------------------------------------------

version: '3.8'

services:
  server:
    image: gitea/gitea:latest
    container_name: gitea
    restart: unless-stopped
    depends_on:
      - db
    ports:
      - "3000:3000"
      - "222:22"
    environment:
      - USER_UID=1000
      - USER_GID=1000
      - GITEA__database__DB_TYPE=postgres
      - GITEA__database__HOST=db:5432
      - GITEA__database__NAME=gitea
      - GITEA__database__USER=gitea
      - GITEA__database__PASSWD=gitea
    volumes:
      - ./data:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro

  db:
    image: postgres:14-alpine
    container_name: gitea-db
    restart: unless-stopped
    environment:
      - POSTGRES_USER=gitea
      - POSTGRES_PASSWORD=gitea
      - POSTGRES_DB=gitea
    volumes:
      - gitea_db:/var/lib/postgresql/data

volumes:
  gitea_db:

Community Notes

Help others by adding context, corrections, or warnings about this tool. Sign in to contribute.

No community notes yet. Be the first to add context.