Git with a cup of tea! Painless self-hosted all-in-one software development service, includes Git hosting, code review, team collaboration, package registry and CI/CD
Go to file
Jean-Philippe Roemer 7679aa1a21 Fix typo & cleanup start.sh code 2015-11-04 19:34:26 +00:00
cmd add Makefile 2015-11-03 12:16:43 -05:00
conf #1511 Allow local import only for admin users 2015-11-03 18:40:52 -05:00
docker Fix typo & cleanup start.sh code 2015-11-04 19:34:26 +00:00
models rename fields 2015-11-03 22:49:06 -05:00
modules rename fields 2015-11-03 22:49:06 -05:00
packager Fix typo 2015-09-25 18:46:50 +02:00
public #1459 Dashboard issues lacks sorting 2015-11-04 12:50:02 -05:00
routers #1459 Dashboard issues lacks sorting 2015-11-04 12:50:02 -05:00
scripts adding extra check on logpath 2015-10-31 07:32:34 -05:00
templates #1459 Dashboard issues lacks sorting 2015-11-04 12:50:02 -05:00
.bra.toml new quick start page 2015-10-02 19:58:36 -04:00
.dockerignore Docker Container: Init 1 & Initialisation 2015-10-02 23:13:39 +01:00
.editorconfig Added .editorconfig 2015-03-13 21:20:08 -06:00
.gitignore add Makefile 2015-11-03 12:16:43 -05:00
.gopmfile fix import path on x64 systems, fix #1795 2015-10-21 09:00:35 +02:00
.pkgr.yml Add debian-8 and centos-7 2015-07-09 11:47:54 +00:00
.travis.yml Revert "fix CI..." 2015-11-03 13:19:45 -05:00
CONTRIBUTING.md fix typo 2015-10-09 22:09:07 -04:00
Dockerfile Update gosu, this fixes #1756 2015-10-10 20:48:26 +02:00
LICENSE Work on #5 fork and fix #608 2014-11-05 23:30:04 -05:00
Makefile add Makefile 2015-11-03 12:16:43 -05:00
README.md #1459 Dashboard issues lacks sorting 2015-11-04 12:50:02 -05:00
README_ZH.md update README 2015-10-29 03:21:59 -04:00
config.codekit fix codekit 2015-09-16 15:36:21 -04:00
docker-compose.yml Adding a project-level Dockerfile & docker-compose script 2015-03-10 07:06:10 -07:00
gogs.go #1459 Dashboard issues lacks sorting 2015-11-04 12:50:02 -05:00

README.md

Gogs - Go Git Service Build Status

Gitter

Current version: 0.6.25 Beta

NOTICES

  • Due to testing purpose, data of try.gogs.io has been reset in Jan 28, 2015 and will reset multiple times after. Please do NOT put your important data on the site.
  • The demo site try.gogs.io is running under develop branch.
  • You MUST read CONTRIBUTING.md before you start filing an issue or making a Pull Request, and MUST discuss with us on Gitter for UI changes and feature Pull Requests, otherwise it's high possibilities that we are not going to merge it.
  • If you think there are vulnerabilities in the project, please talk privately to u@gogs.io. Thanks!

Other language version

Purpose

The goal of this project is to make the easiest, fastest, and most painless way of setting up a self-hosted Git service. With Go, this can be done with an independent binary distribution across ALL platforms that Go supports, including Linux, Mac OS X, and Windows.

Overview

  • Please see the Documentation for project design, known issues, and change log.
  • See the Trello Board to follow the develop team.
  • Want to try it before doing anything else? Do it online or go down to the Installation -> Install from binary section!
  • Having trouble? Get help with Troubleshooting.
  • Want to help with localization? Check out the guide!

Features

  • Activity timeline
  • SSH and HTTP/HTTPS protocols
  • SMTP/LDAP/Reverse proxy authentication
  • Reverse proxy with sub-path
  • Account/Organization/Repository management
  • Repository/Organization webhooks (including Slack)
  • Repository Git hooks/deploy keys
  • Repository issues and pull requests
  • Add/Remove repository collaborators
  • Gravatar and custom source
  • Mail service
  • Administration panel
  • CI integration: Drone
  • Supports MySQL, PostgreSQL, SQLite3 and TiDB
  • Multi-language support (14 languages)

System Requirements

  • A cheap Raspberry Pi is powerful enough for basic functionality.
  • At least 2 CPU cores and 1GB RAM would be the baseline for teamwork.

Browser Support

  • Please see Semantic UI for specific versions of supported browsers.
  • The official support minimal size is 1024*768, UI may still looks right in smaller size but no promises and fixes.

Installation

Make sure you install the prerequisites first.

There are 5 ways to install Gogs:

Tutorials

Screencasts

Deploy to Cloud

Product Support

Acknowledgments

  • Router and middleware mechanism of Macaron.
  • Modules design is inspired by WeTalk.
  • System Monitor Status is inspired by GoBlog.
  • Thanks lavachen and Rocker for designing Logo.
  • Thanks Crowdin for providing open source translation plan.

Contributors

License

This project is under the MIT License. See the LICENSE file for the full license text.