You can change the listening port on the first run by passing the -port flag:

gogs web -port 3001

Make sure to update [server] HTTP_PORT in custom/conf/app.ini to match, so subsequent restarts pick up the same port.

Set the OFFLINE_MODE option to true in the [server] section of your custom/conf/app.ini:

[server]
OFFLINE_MODE = true

This disables external network calls such as CDN resource loading and Gravatar avatar fetching.

Create a file named robots.txt in the custom directory at the root of your Gogs installation:

custom/robots.txt

Gogs will serve this file automatically at /robots.txt.

The first user to register (with ID = 1) is automatically granted administrator privileges. No email confirmation is required for this account, even if email confirmation is enabled.

Once logged in, the administrator can promote other users by navigating to Admin Panel > Users and editing user accounts.

If you have shell access to the server, follow these steps:

1. Stop Gogs, then create a temporary admin user from the command line:

   su git
   cd /home/git/gogs
   gogs admin create-user --name tmpuser --password tmppassword --admin --email tmp@example.com

2. Start Gogs again, then log in as tmpuser in your browser. Navigate to Admin Panel > Users, click Edit next to the original administrator account, and set a new password.

3. Clean up by logging out, logging back in as the original administrator with the new password, then deleting the tmpuser account from Admin Panel > Users.

It is safest to stop Gogs before creating the temporary user via the command line, then start it again afterward.

Git hooks permission is a high-level privilege that can allow arbitrary code execution on the server. Only grant it to users you fully trust.

To enable or disable this permission, go to the Admin Panel > Users, select the user, and toggle the Git hooks permission in their account settings (/admin/users/:userid).

Mirrored repositories cannot have their own wiki because the mirror is a read-only copy of the upstream repository.

If you see the "Welcome to Wiki!" page but no green "Create the first page" button, your repository was likely created as a mirror. You have two options:

1. Edit the wiki on the upstream repository that is being mirrored.
2. Convert the mirror to a regular repository under Settings > Danger Zone if you no longer need it to be a mirror.