gitea/docs/content/doc/installation/from-package.en-us.md

date	title	slug	weight	toc	draft	menu
2016-12-01T16:00:00+02:00	Installation from package	install-from-package	10	true	false	sidebar parent name weight identifier installation From package 20 install-from-package

Installation from package

Debian

Although there is a package of Gitea in Debian's contrib, it is not supported directly by us.

Unfortunately, the package is not maintained anymore and broken because of missing sources. Please follow the [deployment from binary]({{< relref "from-binary.en-us.md" >}}) guide instead.

Should the packages get updated and fixed, we will provide up-to-date installation instructions here.

Alpine Linux

Alpine Linux has gitea in its community repository. It follows the latest stable version. for more information look at https://pkgs.alpinelinux.org/packages?name=gitea&branch=edge.

install as usual:

apk add gitea

config is found in /etc/gitea/app.ini

Windows

There are no published packages for Windows. This page will change when packages are published, in the form of MSI installers or via Chocolatey. In the meantime, follow the [deployment from binary]({{< relref "from-binary.en-us.md" >}}) guide.

macOS

Currently, the only supported method of installation on MacOS is Homebrew. Following the [deployment from binary]({{< relref "from-binary.en-us.md" >}}) guide may work, but is not supported. To install Gitea via brew:

brew tap gitea/tap https://gitea.com/gitea/homebrew-gitea
brew install gitea

FreeBSD

A FreeBSD port www/gitea is available. To install the pre-built binary package:

pkg install gitea

For the most up to date version, or to build the port with custom options, install it from the port:

su -
cd /usr/ports/www/gitea
make install clean

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.

To enable Gitea to run as a service, run sysrc gitea_enable=YES and start it with service gitea start.

Cloudron

Gitea is available as a 1-click install on Cloudron. For those unaware, Cloudron makes it easy to run apps like Gitea on your server and keep them up-to-date and secure.

The Gitea package is maintained here.

There is a demo instance (username: cloudron password: cloudron) where you can experiment with running Gitea.

Third-party

Various other third-party packages of Gitea exist. To see a curated list, head over to awesome-gitea.

Do you know of an existing package that isn't on the list? Send in a PR to get it added!