2017-11-26 16:44:32 -05:00
---
date: "2016-12-01T16:00:00+02:00"
title: "Installation from package"
slug: "install-from-package"
weight: 10
toc: true
draft: false
menu:
sidebar:
parent: "installation"
name: "From package"
weight: 20
identifier: "install-from-package"
---
# Installation from package
2020-12-07 23:52:26 -05:00
{{< toc > }}
2020-11-17 18:51:22 -05:00
## Alpine Linux
2017-11-26 16:44:32 -05:00
2020-11-17 18:51:22 -05: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-08 17:48:42 -05:00
2020-11-17 18:51:22 -05:00
```sh
apk add gitea
```
2018-01-08 17:48:42 -05:00
2020-11-17 18:51:22 -05:00
## Arch Linux
2017-11-26 16:44:32 -05:00
2020-11-17 18:51:22 -05:00
The rolling release distribution has [Gitea ](https://www.archlinux.org/packages/community/x86_64/gitea/ ) in their official community repository and package updates are provided with new Gitea releases.
2020-05-17 07:09:56 -04:00
2020-11-17 18:51:22 -05: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 07:09:56 -04:00
```sh
2020-11-17 18:51:22 -05:00
pacman -S gitea
2020-05-17 07:09:56 -04:00
```
2017-11-26 16:44:32 -05:00
## Windows
2020-05-24 15:17:33 -04:00
There is a [Gitea ](https://chocolatey.org/packages/gitea ) package for Windows by [Chocolatey ](https://chocolatey.org/ ).
2017-11-26 16:44:32 -05:00
2020-05-24 15:17:33 -04:00
```sh
choco install gitea
```
Or follow the [deployment from binary ]({{< relref "from-binary.en-us.md" >}} ) guide.
2017-11-26 16:44:32 -05:00
## macOS
2018-01-08 17:48:42 -05:00
Currently, the only supported method of installation on MacOS is [Homebrew ](http://brew.sh/ ).
Following the [deployment from binary ]({{< relref "from-binary.en-us.md" >}} ) guide may work,
but is not supported. To install Gitea via `brew` :
2017-11-26 16:44:32 -05:00
```
2020-05-12 08:51:41 -04:00
brew tap gitea/tap https://gitea.com/gitea/homebrew-gitea
2017-11-26 16:44:32 -05:00
brew install gitea
```
## FreeBSD
2018-01-08 17:48:42 -05:00
A FreeBSD port `www/gitea` is available. To install the pre-built binary package:
2017-11-26 16:44:32 -05:00
```
pkg install gitea
```
2018-01-08 17:48:42 -05: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-26 16:44:32 -05:00
```
su -
cd /usr/ports/www/gitea
make install clean
```
2018-01-08 17:48:42 -05: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-26 16:44:32 -05:00
2018-01-08 17:48:42 -05:00
To enable Gitea to run as a service, run `sysrc gitea_enable=YES` and start it with `service gitea start` .
2018-09-15 02:28:53 -04:00
## Cloudron
2020-11-28 01:12:22 -05:00
Gitea is available as a 1-click install on [Cloudron ](https://cloudron.io ).
2018-09-15 02:28:53 -04:00
Cloudron makes it easy to run apps like Gitea on your server and keep them up-to-date and secure.
2020-12-07 22:20:37 -05:00
[![Install ](/cloudron.svg )](https://cloudron.io/button.html?app=io.gitea.cloudronapp)
2018-09-15 02:28:53 -04:00
The Gitea package is maintained [here ](https://git.cloudron.io/cloudron/gitea-app ).
2020-06-11 14:38:26 -04:00
There is a [demo instance ](https://my.demo.cloudron.io ) (username: cloudron password: cloudron) where
2018-09-15 02:28:53 -04:00
you can experiment with running Gitea.
2020-05-13 18:58:49 -04:00
## Third-party
2020-11-28 01:12:22 -05:00
Various other third-party packages of Gitea exist.
2020-05-13 18:58:49 -04: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!