Initial Configuration

If you run Gitea inside Docker, please read the documentation before changing any settings.

Database Settings

Gitea requires MySQL, PostgreSQL, MSSQL, SQLite3 or TiDB (MySQL protocol).

Database Type

sqlite3

MySQL

PostgreSQL

MSSQL

SQLite3

Host

Username

Password

Database Name

SSL

disable

Disable

Require

Verify Full

Schema Leave blank for database default ("public").

Path File path for the SQLite3 database.
Enter an absolute path if you run Gitea as a service.

General Settings

Site Title You can enter your company name here.

Repository Root Path Remote Git repositories will be saved to this directory.

Git LFS Root Path Files tracked by Git LFS will be stored in this directory. Leave empty to disable.

Run As Username The operating system username that Gitea runs as. Note that this user must have access to the repository root path.

Server Domain Domain or host address for the server.

SSH Server Port Port number your SSH server listens on. Leave empty to disable.

Gitea HTTP Listen Port Port number the Gitea web server will listen on.

Gitea Base URL Base address for HTTP(S) clone URLs and email notifications.

Log Path Log files will be written to this directory.

Enable Update Checker

Checks for new version releases periodically by connecting to gitea.io.

Optional Settings

Email Settings

SMTP Host

SMTP Port

Send Email As Email address Gitea will use. Enter a plain email address or use the "Name" <email@example.com> format.

SMTP Username

SMTP Password

Require Email Confirmation to Register

Enable Email Notifications

Server and Third-Party Service Settings

Enable OpenID Sign-In

Disable Self-Registration

Allow Registration Only Through External Services

Enable OpenID Self-Registration

Enable registration CAPTCHA

Require Sign-In to View Pages

Hide Email Addresses by Default

Allow Creation of Organizations by Default

Enable Time Tracking by Default

Hidden Email Domain Domain name for users with a hidden email address. For example, the username 'joe' will be logged in Git as 'joe@noreply.example.org' if the hidden email domain is set to 'noreply.example.org'.

Password Hash Algorithm

pbkdf2

pbkdf2

argon2

bcrypt

scrypt

pbkdf2_hi

Set the password hashing algorithm. Algorithms have differing requirements and strengths. The argon2 algorithm is rather secure but uses a lot of memory and may be inappropriate for small systems.

Backup Settings

Configure automatic backup storage. Backups can be stored locally or remotely via WebDAV. This can also be configured later in the admin panel.

Backup Storage Type

Disabled (no automatic backups)

Disabled (no automatic backups)

Local Filesystem

WebDAV

Backup Path Directory where backup files will be stored locally.

WebDAV URL Full URL to the WebDAV endpoint, e.g. https://webdav.example.com/backups/

WebDAV Username

WebDAV Password

Administrator Account Settings

Creating an administrator account is optional. The first registered user will automatically become an administrator.

Administrator Username

Email Address

Password

Confirm Password

Environment Configuration

The following environment variables will also be applied to your configuration file:

GITEA__database__DB_TYPEGITEA__server__DOMAINGITEA__server__ROOT_URLGITEA__server__LOCAL_ROOT_URLGITEA__server__HTTP_PORT

These configuration options will be written into: /data/gitea/conf/app.ini

Install Gitea