Table of Contents

Initial Configuration

After Gitea is running, complete the initial setup wizard and apply recommended security and integration settings.

What this page covers

  • Completing the Gitea installation wizard
  • Creating the admin account
  • Configuring SSH keys for Git operations
  • Setting up webhooks for CI/CD integration
  • Recommended app.ini settings for production use

Installation wizard

On first access, Gitea presents a configuration wizard. Key settings to configure:

  • Database: use the values from your Docker Compose or Helm configuration
  • Site title: your organization name
  • Admin account: create a strong password; this account has full control
  • Server domain: the FQDN Gitea will use for clone URLs and webhooks

SSH key setup

Add your workstation's public key under User Settings > SSH / GPG Keys so you can push over SSH without entering a password.