License Activation

Activating Gitea Enterprise enables premium features for your instance. Follow the steps below to find your instance ID, obtain a license (or request a trial), and upload it through the administrator interface.

1. Find your instance ID

1. After installing Gitea Enterprise, sign in to your instance as an administrator.
2. Navigate to Site Administration -> Enterprise License.
3. Copy the Instance ID shown on the page. You will need it when requesting or purchasing a license.

2. Obtain a license

You can obtain a license through the online customer portal, or by email and direct payment.

Customer portal

1. Visit the Gitea customers portal and sign in with your organization account.
2. Choose one of the following options:
   • Start a trial: Select Request Trial, enter the required user count and paste your instance ID, then submit the form. A trial license (typically 30 days) will be issued automatically.
   • Purchase a subscription: Create a new license with the required user count and term length, paste your instance ID, then complete the checkout flow.
3. Download the generated license.key file and store it in a secure location.

Email and direct payment

1. Contact Gitea support by email.
2. Provide your instance ID, the required user count and subscription term, and arrange direct payment.
3. The Gitea team will send you the corresponding license.key file.

3. Upload the license in Gitea Enterprise

1. Sign in to your Gitea Enterprise instance as an administrator.
2. Navigate to Site Administration -> Enterprise License.
3. Click Upload License, select the license.key file you obtained, and confirm.
4. The page displays the license status, expiration date, and user count once the upload succeeds.

4. Verify, renew, and rotate

• Post-upgrade checks: After upgrading or redeploying Gitea Enterprise, revisit Site Administration -> Enterprise License to ensure the license is still valid.
• Renewals and resizing: Use the customers portal or contact Gitea support by email to renew, resize, or replace a license. Upload the updated license.key through the same administrator page.
• Security: Treat the license file as a secret. Store it in an access-controlled vault and limit who can download or upload it.

Once the license is active, all Enterprise functionality becomes available immediately—no service restart is required.