Skip to main content
Version: 1.0

Gogs Getting Started

Gogs is a painless self-hosted Git service.This project aims to build a simple, stable and extensible self-hosted Git service that can be setup in the most painless way. With Go, this can be done with an independent binary distribution across ALL platforms that Go supports, including Linux, macOS, Windows and ARM.

If you have installed Websoft9 Gogs, the following steps is for your quick start


  1. Get the Internet IP of your Server on Cloud
  2. Check your Inbound of Security Group Rule of Cloud Console to ensure the TCP:80 is allowed
  3. Complete Five steps for Domain if you want to use Domain for Gogs.
  4. Get default username and password of Gogs

Gogs Initialization

Steps for you

  1. Using local Chrome or Firefox to visit the URL https://DNS or https://Server's Internet IP, you can access the initialization page.

  2. Connect to the database(default username and password

    • Database Type: MySQL
    • Host:gogs-db

  3. Set the Gogs parameters

    • Domain:Public IP or DNS
    • SSH Port: 10022 (Can be obtained or modified from the Gogs root .env file)
    • HTTP Port: 80
    • Application URL:http://IP or http://DNS

  4. Set up an administrative account

  5. Complete the settings and enter the Dashboard

Having trouble?

Below is for you to solve problem, and you can contact Websoft9 Support or refer to Troubleshoot + FAQ to get more.

Gogs QuickStart

Gogs Setup

Reference sheet

The below items and General parameter sheet is maybe useful for you manage Gogs

Run docker ps command, view all Containers when Gogs is running::

CONTAINER ID   IMAGE               COMMAND                  CREATED          STATUS                    PORTS                                                                                NAMES
3cc976ef4fd5 mysql:5.7 "docker-entrypoint.s…" 19 minutes ago Up 19 minutes 3306/tcp, 33060/tcp gogs-db
d1bf1977d72b gogs/gogs:latest "/app/gogs/docker/st…" 19 minutes ago Up 19 minutes (healthy)>3000/tcp, :::3000->3000/tcp,>22/tcp, :::10022->22/tcp gogs


Gogs installation directory: /data/apps/gogs


10022Gogs SSHOptional


docker inspect gogs | grep com.docker.compose.version


sudo docker start | stop | restart | stats gogs


$ ./gogs -h
Gogs - A painless self-hosted Git service

gogs [global options] command [command options] [arguments...]


web Start web server
serv This command should only be called by SSH shell
hook Delegate commands to corresponding Git hooks
cert Generate self-signed certificate
admin Perform admin operations on command line
import Import portable data as local Gogs data
backup Backup files and database
restore Restore files and database from backup
help, h Shows a list of commands or help for one command

--help, -h show help
--version, -v print the version

### API

Refer to :[Webhook](