Purpose

Gitea is a decent Git-based Version Control System (VCS). It especially provides repository browsing, pull requests, and integrated issue tracking. Its user interface directly resembles the popular Github service. Gitea is considered the successor of Gogs.

Properties

Topology

The stack is comprised of three containers:

• vcs-gitea is a haproxy instance which allows restart of the service without connections getting dropped
• vcs-gitea-app hosts the Gitea application
• vcs-gitea-postgresql hosts the RDBMS which provides persistence

Initial Configuration

Clicking on Register or Log In at the top right brings up the inital configuration panel. Gitea wants you to go through it before first use. It is already filled with sensible default settings which should be ok for most uses. Specifically do not change the database settings as otherwise the Gitea container won't find a way to its database container.

At the very bottom of this page you should create the admin account by opening Administrator Settings. (Should you decide not to create the account here then the first user which will register automatically has admin permission.)

For creating the admin account please note that

• gitea requires passwords to be at least 8 characters long
• the username "admin" is reserved and cannot be used

You finish the initial configuration screen by pressing the button Install Gitea. Gitea will now complete the initial configuration, this  takes a few seconds. You are then dropped into the overview screen.

The symbol on the very top right opens the main menu (see screenshot to the right). As administrator an additional menu item Site Administration is available where you find all administrative tasks like account management, organisations and repositories, webhooks etc.

In Gitea work usually starts with creation of a repository. Use the menu behind the "plus" icon on the top right for this purpose. Gitea is pretty similar to Github, so repositories either belong to a user or to an organization.

The Dashboard link on the top left returns you to the entry page at any time.

Find more in the Gitea docs.

Good To Know

• Note that due to the HAproxy prepended to the processing chain Gitea is executing in the vcs-gitea-app container, not in vcs-gitea (that's where HAproxy resides).

• Settings are stored in a config file located at /app/etc/gitea.ini. A concise explanation of its config directives can be found at https://docs.gitea.io/en-us/config-cheat-sheet/.

• Logfiles can be found in /data/gitea/runtime-logs. There is an access log containing al web accesses and a "gitea" log for daemon status and error messages.

Administration Commands

Related Documents

• Most recent changes

• HowTo: Using Keycloak as identity provider for Gitea