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

3.2 KiB

Raw Blame History

date

title

slug

weight

toc

draft

aliases

2016-12-01T16:00:00+02:00

Installation from package

install-from-package

false

/en-us/install-from-package

sidebar

parent	name	weight	identifier
installation	From package	20	install-from-package

Table of Contents

Official packages

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

Unofficial packages

Alpine Linux

Alpine Linux has Gitea in its community repository which follows the latest stable version.

apk add gitea

Arch Linux

The rolling release distribution has Gitea in their official community repository and package updates are provided with new Gitea releases.

pacman -S gitea

Arch Linux ARM

Arch Linux ARM provides packages for aarch64, armv7h and armv6h.

pacman -S gitea

Gentoo Linux

The rolling release distribution has Gitea in their official community repository and package updates are provided with new Gitea releases.

emerge gitea -va

Canonical Snap

There is a Gitea Snap package which follows the latest stable version.

snap install gitea

SUSE and openSUSE

OpenSUSE build service provides packages for openSUSE and SLE in the Development Software Configuration Management Repository

Windows

There is a Gitea package for Windows by Chocolatey.

choco install gitea

Or follow the [deployment from binary]({{< relref "from-binary.en-us.md" >}}) guide.

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.

Others

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!

3.2 KiB Raw Blame History