mirror of
https://github.com/gogs/gogs.git
synced 2026-02-08 23:47:02 +01:00
78 lines
3.1 KiB
Plaintext
78 lines
3.1 KiB
Plaintext
---
|
|
title: "Installation"
|
|
description: "Get your own Git service up and running in minutes"
|
|
icon: "download"
|
|
---
|
|
|
|
## Prerequisites
|
|
|
|
1. Gogs requires use of one of the following database backends:
|
|
- MySQL, >= 5.7
|
|
- PostgreSQL, >= 9.6
|
|
- SQLite 3
|
|
1. Git, >= 1.8.3, on both server and client side
|
|
1. SSH server
|
|
- Only required when enable Git over SSH, e.g., `git clone git@gogs.example.com:...`
|
|
- Builtin SSH server is also available
|
|
|
|
<Note>
|
|
**For Windows users:**
|
|
|
|
- When using builtin SSH server, you still need to have `ssh-keygen` installed and available via the `%PATH%` environment variable.
|
|
- Use [OpenSSH](https://learn.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse) on Windows 10 or newer.
|
|
- [Cygwin OpenSSH](http://docs.oracle.com/cd/E24628_01/install.121/e22624/preinstall_req_cygwin_ssh.htm) or [Copssh](https://www.itefix.net/copssh) are available on older versions of Windows.
|
|
</Note>
|
|
|
|
## Initialize database
|
|
|
|
If you choose to use MySQL or PostgreSQL as your database backend, you need to first complete the initial database creation.
|
|
|
|
<Tabs>
|
|
<Tab title="PostgreSQL">
|
|
Create a database user and database:
|
|
|
|
```bash
|
|
psql -c "CREATE USER gogs WITH PASSWORD '{YOUR_PASSWORD}';"
|
|
psql -c "CREATE DATABASE gogs OWNER gogs ENCODING 'UTF8';"
|
|
```
|
|
</Tab>
|
|
<Tab title="MySQL">
|
|
Use the [bundled script](https://github.com/gogs/gogs/blob/main/scripts/mysql.sql) to create the database with proper encoding:
|
|
|
|
```zsh
|
|
mysql -u root -p < scripts/mysql.sql
|
|
```
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
## Installation methods
|
|
|
|
<Tabs>
|
|
<Tab title="Pre-built binary">
|
|
All release archives containing pre-built binaries are available in [dl.gogs.io](https://dl.gogs.io) and [GitHub releases](https://github.com/gogs/gogs/releases).
|
|
|
|
<Note>
|
|
**For Windows users:**
|
|
|
|
Release archives containing `mws` come with built-in Windows service support. If you prefer to manage the service using [NSSM](https://nssm.cc), download the standard version instead.
|
|
</Note>
|
|
|
|
Once extracted the archive, run `./gogs web` to start the server. Use `./gogs web --help` to see all available options.
|
|
</Tab>
|
|
<Tab title="Docker">
|
|
Two types of Docker images are provided:
|
|
1. [docker-next](https://github.com/gogs/gogs/blob/main/docker-next/README.md): The modern, non-root, and cloud-native version, but with no container options.
|
|
1. [docker](https://github.com/gogs/gogs/blob/main/docker/README.md): The traditional, root-privileged version, with extensive container options.
|
|
</Tab>
|
|
<Tab title="Packages">
|
|
<Warning>
|
|
All packages listed below are packaged by third-party maintainers. Use at your own risk.
|
|
</Warning>
|
|
|
|
|Source| Description | Note|
|
|
|------|------------------------------------------|-----|
|
|
|Packager.io ([link](https://packager.io/gh/gogs/gogs))|Every commit of `main`|After installation, place custom configuration in `/etc/default/gogs`.|
|
|
|Arch User Repository ([link](https://aur.archlinux.org/packages/gogs/))| Stable releases | Detailed instructions available in the [Arch Linux Wiki entry](https://wiki.archlinux.org/title/Gogs). |
|
|
</Tab>
|
|
</Tabs>
|