Gitea

Your own GitHub-style home for code, with issues, reviews and CI

  • gitea/gitea:28.4.0
  • v28.4.0
  • Updated 22 Nov 2026
  • port 6795
  • port 6796
  • amd64 · arm64
  • Developer
  • 59.2k stars

Screenshots

Gitea screenshot 1: DashboardGitea screenshot 2: IssuesGitea screenshot 3: Pull requestsGitea screenshot 4: Explore

Open the app

Gitea

http://localhost:6795/

API

http://localhost:6795/api/swagger

About Gitea

Gitea is a light Git server for you or your team. Keep your code at home with pull requests, issues, a wiki, package registries and GitHub-style Actions, in one small app.

Features

  • Git over HTTP and SSH, with LFS
  • Pull requests with code review, issues, milestones and projects
  • Gitea Actions, compatible with GitHub Actions workflows
  • Package registry for Docker, npm, PyPI, Maven and more
  • Mirror repositories from GitHub and other sites
  • Organizations, teams, wikis and webhooks

How to use

  1. Open Gitea from your dashboard. You see the setup page first.
  2. Keep SQLite as the database. Check the Server Domain and Gitea Base URL show your ZimaOS address.
  3. Open Administrator Account Settings at the bottom, make the admin and click Install Gitea.
  4. Click + and New Repository, then push your code.

Before you install

Right after installing, open http://[ZIMAOS-IP-ADDRESS]:6795 and fill in the setup page; until you do, anyone on your network can. Keep SQLite, set Server Domain to your ZimaOS IP and Gitea Base URL to http://[ZIMAOS-IP-ADDRESS]:6795/ so clone links work, and make the admin account at the bottom. Git over SSH is on port 6796 (ssh://git@[ZIMAOS-IP-ADDRESS]:6796/user/repo.git). Gitea makes its own secret keys and keeps everything in /DATA/AppData/gitea/data. Sign-up, email and other settings are in the Variables tab and are added in the app settings; any GITEA__section__KEY setting from Gitea's config cheat sheet works the same way. Gitea Actions needs a separate runner (act_runner). It is ready in under a minute.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. It is filled in from your ZimaOS time zone.
USER_UID$PUIDThe user Gitea keeps your repositories as. It is filled in by ZimaOS.
USER_GID$PGIDThe group Gitea keeps your repositories as. It is filled in by ZimaOS.
GITEA__server__SSH_PORT6796The SSH port shown in clone addresses. Keep it the same as the host port for SSH (6796).

Server

VariableDefault valueDescription
GITEA__server__ROOT_URL—The address people open Gitea at, like http://[ZIMAOS-IP-ADDRESS]:6795/ or https://git.example.com/. Used in clone links and emails. The setup page sets it too.
GITEA__server__DOMAIN—The host name or IP shown in clone links, like 192.168.1.20 or git.example.com.

Sign-up and accounts

VariableDefault valueDescription
GITEA__service__DISABLE_REGISTRATIONfalseSet to true so only the admin can make new accounts.
GITEA__service__REQUIRE_SIGNIN_VIEWfalseSet to true so people must sign in to see any page.

Email (SMTP)

VariableDefault valueDescription
GITEA__mailer__ENABLEDfalseSet to true to send emails (sign-up confirmation, notifications).
GITEA__mailer__PROTOCOL—smtp, smtps or smtp+starttls.
GITEA__mailer__SMTP_ADDR—Your mail server, like smtp.gmail.com.
GITEA__mailer__SMTP_PORT—Your mail server's port, like 465 or 587.
GITEA__mailer__USER—The user name for your mail server.
GITEA__mailer__PASSWD—The password for your mail server.
GITEA__mailer__FROM—The sender address, like Gitea <[email protected]>.

Features

VariableDefault valueDescription
GITEA__actions__ENABLEDtrueSet to false to turn off Gitea Actions. Running jobs needs a separate act_runner.

Logs

VariableDefault valueDescription
GITEA__log__LEVELInfoHow much Gitea writes to the log: Trace, Debug, Info, Warn or Error.
docker-compose.yml
name: gitea

services:
  gitea:
    image: gitea/gitea:28.4.0
    container_name: gitea
    restart: unless-stopped
    stop_grace_period: 30s
    network_mode: bridge
    environment:
      - TZ=$TZ
      - USER_UID=$PUID
      - USER_GID=$PGID
      - GITEA__server__SSH_PORT=6796
    ports:
      - target: 3000
        published: "6795"
        protocol: tcp
      - target: 22
        published: "6796"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /data
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "curl", "-fsS", "-o", "/dev/null", "http://127.0.0.1:3000/api/healthz"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 60s
    deploy:
      resources:
        limits:
          cpus: "2.00"
          memory: 1G
        reservations:
          cpus: "0.05"
          memory: 128M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/gitea/icon.png
    x-casaos:
      id: com.icestore.gitea
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone.
        - container: USER_UID
          description:
            en_US: >-
              The user Gitea keeps your repositories as. It is filled in by
              ZimaOS.
        - container: USER_GID
          description:
            en_US: >-
              The group Gitea keeps your repositories as. It is filled in by
              ZimaOS.
        - container: GITEA__server__SSH_PORT
          description:
            en_US: >-
              The SSH port shown in clone addresses. Keep it the same as the
              host port for SSH (6796).
      ports:
        - container: "3000"
          description:
            en_US: Gitea web pages, API and git over HTTP, published on host as 6795
        - container: "22"
          description:
            en_US: Git over SSH, published on host as 6796
      volumes:
        - container: /data
          description:
            en_US: >-
              Your repositories, the database (SQLite by default), uploads,
              LFS files and app.ini with Gitea's own secret keys. Back it
              up.

x-casaos:
  id: com.icestore.gitea
  architectures:
    - amd64
    - arm64
  main: gitea
  author: HSinghHira
  category: Developer
  developer: Gitea
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/gitea/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/gitea/screenshot-1.png
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/gitea/screenshot-1.png
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/gitea/screenshot-2.png
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/gitea/screenshot-3.png
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/gitea/screenshot-4.png
  title:
    en_US: Gitea
  tagline:
    en_US: Your own GitHub-style home for code, with issues, reviews and CI
  description:
    en_US: >-
      Gitea is a light Git server for you or your team. Keep your code at
      home with pull requests, issues, a wiki, package registries and
      GitHub-style Actions, in one small app.


      **Features**


      - Git over HTTP and SSH, with LFS

      - Pull requests with code review, issues, milestones and projects

      - Gitea Actions, compatible with GitHub Actions workflows

      - Package registry for Docker, npm, PyPI, Maven and more

      - Mirror repositories from GitHub and other sites

      - Organizations, teams, wikis and webhooks


      **How to use?**


      1. Open Gitea from the ZimaOS dashboard. You see the setup page
         first.

      2. Keep SQLite as the database. Check the Server Domain and Gitea
         Base URL show your ZimaOS address.

      3. Open Administrator Account Settings at the bottom, make the admin
         and click Install Gitea.

      4. Click + and New Repository, then push your code.
  tips:
    before_install:
      en_US: >-
        1. Start the installation. It is ready in under a minute.


        2. Right away, open http://[ZIMAOS-IP-ADDRESS]:6795 and fill in the
           setup page. Keep SQLite.


        3. Set Server Domain to your ZimaOS IP and Gitea Base URL to
           http://[ZIMAOS-IP-ADDRESS]:6795/ so clone links work.


        4. Make the admin account at the bottom of the page, then click
           Install Gitea. Until you do, anyone on your network can.


        5. More settings, like sign-up and email, are listed on the Gitea
           page at https://icestore.hsinghhira.me/app/gitea/ (Variables
           tab). You can add them now or later in the app settings.
  index: /
  port_map: "6795"
  scheme: http
  is_uncontrolled: false
  version: "28.4.0"
  update_at: "2026-11-22"
  release_notes:
    en_US: |-
      - First IceStore release; web on port 6795, git over SSH on 6796
      - The official gitea/gitea 28.4.0 image; the setup page makes the admin and Gitea's own secret keys
  repo: "https://github.com/go-gitea/gitea"
  support: "https://github.com/go-gitea/gitea/issues"
  docs: "https://docs.gitea.com/"

Install Gitea

Something not working with Gitea?

Report it so it gets fixed, or ask for an app that is not here yet.

More Developer apps

See all