Go to file
Unknwon ced212f8fa fix hidden bug on tpl rendering 2015-07-10 17:26:50 +08:00
cmd remove extra space in ssh authentication message 2015-04-02 22:22:58 +02:00
conf add more gitignores 2015-07-09 19:46:42 +08:00
docker
etc
models check master as default branch when migrate 2015-07-05 18:34:16 +08:00
modules add more gitignores 2015-07-09 19:46:42 +08:00
packager
public UI: install - done 2015-07-09 13:17:48 +08:00
routers fix hidden bug on tpl rendering 2015-07-10 17:26:50 +08:00
scripts fix typo in centos init script 2015-04-01 00:45:00 +02:00
templates fix #1112 2015-07-10 16:51:25 +08:00
.bra.toml
.editorconfig
.gitignore
.gopmfile add config options for HELO 2015-07-03 14:08:18 +08:00
.pkgr.yml
.travis.yml Add PAM authentication 2015-04-24 10:13:01 +02:00
CONTRIBUTING.md
Dockerfile
LICENSE
README.md UI: install - done 2015-07-09 13:17:48 +08:00
README_ZH.md UI: install - done 2015-07-09 13:17:48 +08:00
docker-compose.yml
gogs.go fix #1112 2015-07-10 16:51:25 +08:00

README.md

Gogs - Go Git Service Build Status

Gitter

Gogs (Go Git Service) is a painless self-hosted Git service.

Demo

Current version: 0.6.1 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 to set up a self-hosted Git service. With Go, this can be done via 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/HTTP(S) protocol support
  • SMTP/LDAP/reverse proxy authentication support
  • Reverse proxy suburl support
  • Register/delete/rename account
  • Create/manage/delete organization with team management
  • Create/fork/migrate/mirror/delete/watch/rename/transfer public/private repository
  • Repository viewer/release/issue tracker
  • Repository and Organization level webhooks
  • Repository Git hooks
  • Add/remove repository collaborators
  • Gravatar and cache support
  • Mail service (register, issue)
  • Administration panel
  • Slack webhook integration
  • Drone CI integration
  • Supports MySQL, PostgreSQL and SQLite3
  • Social account login (GitHub, Google, QQ, Weibo)
  • Multi-language support (12 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

According to Semantic UI:

  • Last 2 Versions FF, Chrome, IE 10+
  • Safari 6
  • IE 9+ (Browser prefix only)
  • Android 4
  • Blackberry 10

Browser prefixes are present for Internet Explorer 9, but the browser is not officially supported.

Installation

Make sure you install the prerequisites first.

There are 5 ways to install Gogs:

Acknowledgments

  • Router and middleware mechanism of Macaron.
  • Mail Service, modules design is inspired by WeTalk.
  • System Monitor Status is inspired by GoBlog.
  • Thanks lavachen and Rocker for designing Logo.
  • Thanks gobuild.io for providing binary compile and download service.
  • 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.