How to Install and Run Gogs: A Lightweight Self‑Hosted Git Service

Overview

Gogs is an open‑source Git‑based file and code management system that can be self‑hosted. It is written in Go and distributed as a single binary, so it runs on any platform supported by Go (Linux, macOS, Windows, ARM, etc.).

Key Features

Easy installation : binaries are available for direct download; Docker images, Vagrant boxes, and package‑manager recipes are also provided.

Cross‑platform : works on all operating systems where Go runs.

Lightweight : can operate on low‑cost hardware such as a Raspberry Pi or a NAS device.

Core Functionality

Remote repository creation and management.

Fine‑grained repository permission control.

Team and organization management.

Built‑in code review and pull‑request workflow.

Binary Installation (example version 0.13.0)

Binaries are published on the GitHub releases page:

https://github.com/gogs/gogs/releases

wget https://dl.gogs.io/0.13.0/gogs_0.13.0_linux_amd64.tar.gz

tar -zxvf gogs_0.13.0_linux_amd64.tar.gz

cd gogs/

Start the server to verify the installation: ./gogs web If the process starts without error messages, Gogs is running. Stop the server with Ctrl‑C.

Initial Configuration

After launching ./gogs web, open a web browser and navigate to the default address http://localhost:3000. The web installer guides you through:

Database selection (SQLite, MySQL, PostgreSQL, or TiDB).

Application URL, server port, and SSH port.

Administrator account creation.

Once the wizard completes, you can log in with the admin credentials and create repositories, users, and teams via the web UI.

Typical Post‑Installation Steps

Configure a reverse proxy (e.g., Nginx) to expose Gogs over HTTPS.

Set up SSH keys for users to enable push/pull over SSH.

Adjust app.ini (found in custom/conf/) for custom settings such as email notifications, OAuth providers, and LDAP integration.