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

Preparation

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)   0.0.0.0:3000->3000/tcp, :::3000->3000/tcp, 0.0.0.0:10022->22/tcp, :::10022->22/tcp   gogs

Path

Gogs installation directory: /data/apps/gogs

Port

Port	Use	Necessity
10022	Gogs SSH	Optional

Version

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

Service

sudo docker start | stop | restart | stats gogs

CLI

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

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

VERSION:
   0.13.0+dev

COMMANDS:
   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

GLOBAL OPTIONS:
   --help, -h     show help
   --version, -v  print the version


### API

Refer to ：[Webhook](https://gogs.io/docs/features/webhook)