Initial configuration

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

Database settings

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

postgres
MySQL
PostgreSQL
MSSQL
SQLite3
disable
Disable
Require
Verify Full
Leave blank for database default ("public").
File path for the SQLite3 database.
Enter an absolute path if you run Forgejo as a service.

General settings

You can enter your company name here.
Remote Git repositories will be saved to this directory.
Files tracked by Git LFS will be stored in this directory. Leave empty to disable.
The operating system username that Forgejo runs as. Note that this user must have access to the repository root path.
Domain or host address for the server.
Port number that will be used by the SSH server. Leave empty to disable SSH server.
Port number that will be used by the Forgejo web server.
Base address for HTTP(S) clone URLs and email notifications.
Log files will be written to this directory.
It will periodically check for new Forgejo versions by checking a TXT DNS record at release.forgejo.org.

Optional settings

Email settings
Email address Forgejo will use. Enter a plain email address or use the "Name" <email@example.com> format.
Server and third-party service settings
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".
pbkdf2_hi
pbkdf2
argon2
bcrypt
scrypt
pbkdf2_hi
Set the password hashing algorithm. Algorithms have differing requirements and strength. The argon2 algorithm is rather secure but uses a lot of memory and may be inappropriate for small systems.
Administrator account settings

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

These configuration options will be saved in: /data/gitea/conf/app.ini