{mtitle title="正文开始"/}
{lamp/}

安装前的准备

服务器

支持安装有Mac、linux、Windows系统的电脑或虚拟机

{message type="success" content="本教程使用的是CentOS 7"/}

数据库

支持以下数据库：

• MySQL：版本 >= 5.7（本教程使用）
• PostgreSQL
• MSSQL
• TiDB（实验性支持，使用 MySQL 协议连接）
• 或者 什么都不安装 直接使用 SQLite3

Git支持

• 服务端和客户端均需版本 >= 1.7.1
• Windows 系统建议使用最新版

SSH服务器配置

{message type="info" content="如果您只使用 HTTP/HTTPS 的话请忽略此项"/}

• 如果您选择在 Windows 系统使用内置 SSH 服务器，请确保添加 ssh-keygen 到您的 %PATH% 环境变量中
• Windows系统推荐使用 Cygwin OpenSSH 或 Copssh

{dotted startColor="#ff6c6c" endColor="#1989fa"/}

二进制安装

1. 前往GitHub下载服务器对应版本的二进制包，本教程应该下载的包为：linux_amd64.tar.gz
   
2. 解压安装包，使用命令cd进入安装目录，执行./gogs web来运行gogs，或执行nohup ./gogs web在后台运行gogs。

{dotted startColor="#ff6c6c" endColor="#1989fa"/}

初始化配置

【一】新建gogs数据库

• 数据库名：gogs（可自行修改）
• 字符集：utf8
• 排序规则：utf8_general_ci
  

【二】进入配置页面

在浏览器输入 http://localhost:3000/ 进入Gogs，第一次进入会自动跳转到首次运行安装程序页面

{message type="success" content="Gogs默认端口为3000"/}

如果进入页面样式404或者后续配置中有提示权限不足的，请赋予gogs文件夹操作权限：

sudo chmod -R 777 gogs/

【三】配置数据库：

• 数据库类型：MySQL
• 数据库主机：Mysql主机地址，如127.0.0.1:3306

• 数据库用户名：root

  • 数据库用户密码
  • 数据库名称：第一步时新建的数据库名称
    

【四】应用基本设置

{message type="info" content="新手可全部默认，请注意运行系统用户必须是当前用户，且具有操作权限"/}

【五】可选设置

• 邮件服务设置（可选，内部使用的话可以不设置）
  
• 服务器和其他服务设置（请根据个人需求自行选择）
  
• 管理员帐号设置（建议设置）
  

【六】完成设置

点击立即安装保存配置，安装完成后自动进入首页，安装完成。

{lamp/}
{mtitle title="正文结束"/}