2017-11-27 05:44:32 +08:00
---
date: "2016-12-01T16:00:00+02:00"
title: "Installation from package"
slug: "install-from-package"
2023-07-26 10:00:14 +08:00
sidebar_position: 20
2020-12-09 14:47:06 +08:00
toc: false
2017-11-27 05:44:32 +08:00
draft: false
Refactor docs (#23752)
This was intended to be a small followup for
https://github.com/go-gitea/gitea/pull/23712, but...here we are.
1. Our docs currently use `slug` as the entire URL, which makes
refactoring tricky (see https://github.com/go-gitea/gitea/pull/23712).
Instead, this PR attempts to make future refactoring easier by using
slugs as an extension of the section. (Hugo terminology)
- What the above boils down to is this PR attempts to use directory
organization as URL management. e.g. `usage/comparison.en-us.md` ->
`en-us/usage/comparison/`, `usage/packages/overview.en-us.md` ->
`en-us/usage/packages/overview/`
- Technically we could even remove `slug`, as Hugo defaults to using
filename, however at least with this PR it means `slug` only needs to be
the name for the **current file** rather than an entire URL
2. This PR adds appropriate aliases (redirects) for pages, so anything
on the internet that links to our docs should hopefully not break.
3. A minor nit I've had for a while, renaming `seek-help` to `support`.
It's a minor thing, but `seek-help` has a strange connotation to it.
4. The commits are split such that you can review the first which is the
"actual" change, and the second is added redirects so that the first
doesn't break links elsewhere.
---------
Signed-off-by: jolheiser <john.olheiser@gmail.com>
2023-04-28 11:33:41 +08:00
aliases:
- /en-us/install-from-package
2017-11-27 05:44:32 +08:00
menu:
sidebar:
parent: "installation"
name: "From package"
2023-07-26 10:00:14 +08:00
sidebar_position: 20
2017-11-27 05:44:32 +08:00
identifier: "install-from-package"
---
2023-04-06 17:06:32 +08:00
# Official packages
## macOS
Currently, the only supported method of installation on MacOS is [Homebrew ](http://brew.sh/ ).
2023-07-26 10:00:14 +08:00
Following the [deployment from binary ](installation/from-binary.md ) guide may work,
2023-04-06 17:06:32 +08:00
but is not supported. To install Gitea via `brew` :
```
brew tap gitea/tap https://gitea.com/gitea/homebrew-gitea
brew install gitea
```
# Unofficial packages
2020-11-18 07:51:22 +08:00
## Alpine Linux
2017-11-27 05:44:32 +08:00
2020-11-18 07:51:22 +08:00
Alpine Linux has [Gitea ](https://pkgs.alpinelinux.org/packages?name=gitea&branch=edge ) in its community repository which follows the latest stable version.
2018-01-09 06:48:42 +08:00
2020-11-18 07:51:22 +08:00
```sh
apk add gitea
```
2018-01-09 06:48:42 +08:00
2020-11-18 07:51:22 +08:00
## Arch Linux
2017-11-27 05:44:32 +08:00
2023-08-01 23:32:23 +08:00
The rolling release distribution has [Gitea ](https://www.archlinux.org/packages/extra/x86_64/gitea/ ) in their official extra repository and package updates are provided with new Gitea releases.
2020-05-17 19:09:56 +08:00
2020-11-18 07:51:22 +08:00
```sh
pacman -S gitea
```
## Arch Linux ARM
Arch Linux ARM provides packages for [aarch64 ](https://archlinuxarm.org/packages/aarch64/gitea ), [armv7h ](https://archlinuxarm.org/packages/armv7h/gitea ) and [armv6h ](https://archlinuxarm.org/packages/armv6h/gitea ).
2020-05-17 19:09:56 +08:00
```sh
2020-11-18 07:51:22 +08:00
pacman -S gitea
2020-05-17 19:09:56 +08:00
```
2022-12-31 01:14:51 +08:00
## Gentoo Linux
The rolling release distribution has [Gitea ](https://packages.gentoo.org/packages/www-apps/gitea ) in their official community repository and package updates are provided with new Gitea releases.
```sh
emerge gitea -va
```
2021-07-24 21:06:38 +08:00
## Canonical Snap
There is a [Gitea Snap ](https://snapcraft.io/gitea ) package which follows the latest stable version.
2022-07-22 18:12:27 +08:00
```sh
2021-07-24 21:06:38 +08:00
snap install gitea
2022-07-22 18:12:27 +08:00
```
2021-07-24 21:06:38 +08:00
2021-01-23 22:44:00 +08:00
## SUSE and openSUSE
2022-07-28 09:22:47 +08:00
OpenSUSE build service provides packages for [openSUSE and SLE ](https://software.opensuse.org/download/package?package=gitea&project=devel%3Atools%3Ascm )
2021-01-23 22:44:00 +08:00
in the Development Software Configuration Management Repository
2017-11-27 05:44:32 +08:00
## Windows
2020-05-25 03:17:33 +08:00
There is a [Gitea ](https://chocolatey.org/packages/gitea ) package for Windows by [Chocolatey ](https://chocolatey.org/ ).
2017-11-27 05:44:32 +08:00
2020-05-25 03:17:33 +08:00
```sh
choco install gitea
```
2023-07-26 10:00:14 +08:00
Or follow the [deployment from binary ](installation/from-binary.md ) guide.
2020-12-09 14:47:06 +08:00
2017-11-27 05:44:32 +08:00
## FreeBSD
2018-01-09 06:48:42 +08:00
A FreeBSD port `www/gitea` is available. To install the pre-built binary package:
2017-11-27 05:44:32 +08:00
```
pkg install gitea
```
2018-01-09 06:48:42 +08:00
For the most up to date version, or to build the port with custom options,
[install it from the port ](https://www.freebsd.org/doc/handbook/ports-using.html ):
2017-11-27 05:44:32 +08:00
```
su -
cd /usr/ports/www/gitea
make install clean
```
2018-01-09 06:48:42 +08:00
The port uses the standard FreeBSD file system layout: config files are in `/usr/local/etc/gitea` ,
bundled templates, options, plugins and themes are in `/usr/local/share/gitea` , and a start script
is in `/usr/local/etc/rc.d/gitea` .
2017-11-27 05:44:32 +08:00
2018-01-09 06:48:42 +08:00
To enable Gitea to run as a service, run `sysrc gitea_enable=YES` and start it with `service gitea start` .
2018-09-15 14:28:53 +08:00
2023-04-06 17:06:32 +08:00
## Others
2020-05-14 06:58:49 +08:00
2020-11-28 14:12:22 +08:00
Various other third-party packages of Gitea exist.
2020-05-14 06:58:49 +08:00
To see a curated list, head over to [awesome-gitea ](https://gitea.com/gitea/awesome-gitea/src/branch/master/README.md#user-content-packages ).
Do you know of an existing package that isn't on the list? Send in a PR to get it added!
