mirror of
https://github.com/go-gitea/gitea.git
synced 2024-08-21 20:13:24 +02:00
* Rename h3 title * Add intro Should work on Ubuntu Xenial, but should work on any Linux distros. * Indirect edit files Instead of providing `sudo vim`, invite to edit files. * enable now instead of enable and start * Re-add systemctl enable && systemctl start * Revert service enablement back to status quo * Add enable now counterpart for systemd > v220 * Apply suggestions from @sapk Strip `vim` from editor usage Co-Authored-By: Antoine GIRARD <sapk@users.noreply.github.com> Co-authored-by: Antoine GIRARD <sapk@users.noreply.github.com>
70 lines
1.9 KiB
Markdown
70 lines
1.9 KiB
Markdown
---
|
|
date: "2017-07-21T12:00:00+02:00"
|
|
title: "Run as service in Linux"
|
|
slug: "linux-service"
|
|
weight: 10
|
|
toc: true
|
|
draft: false
|
|
menu:
|
|
sidebar:
|
|
parent: "installation"
|
|
name: "Linux service"
|
|
weight: 20
|
|
identifier: "linux-service"
|
|
---
|
|
|
|
### Run Gitea as Linux service
|
|
|
|
You can run Gitea as service, using either systemd or supervisor. The steps below tested on Ubuntu 16.04, but those should work on any Linux distributions (with little modification).
|
|
|
|
#### Using systemd
|
|
|
|
Copy the sample [gitea.service](https://github.com/go-gitea/gitea/blob/master/contrib/systemd/gitea.service) to `/etc/systemd/system/gitea.service`, then edit the file with your favorite editor.
|
|
|
|
Uncomment any service that needs to be enabled on this host, such as MySQL.
|
|
|
|
Change the user, home directory, and other required startup values. Change the
|
|
PORT or remove the -p flag if default port is used.
|
|
|
|
Enable and start Gitea at boot:
|
|
```
|
|
sudo systemctl enable gitea
|
|
sudo systemctl start gitea
|
|
```
|
|
|
|
If you have systemd version 220 or later, you can enable and immediately start Gitea at once by:
|
|
```
|
|
sudo systemctl enable gitea --now
|
|
```
|
|
|
|
#### Using supervisor
|
|
|
|
Install supervisor by running below command in terminal:
|
|
```
|
|
sudo apt install supervisor
|
|
```
|
|
|
|
Create a log dir for the supervisor logs:
|
|
```
|
|
# assuming Gitea is installed in /home/git/gitea/
|
|
mkdir /home/git/gitea/log/supervisor
|
|
```
|
|
|
|
Append the configuration from the sample
|
|
[supervisord config](https://github.com/go-gitea/gitea/blob/master/contrib/supervisor/gitea) to `/etc/supervisor/supervisord.conf`.
|
|
|
|
Using your favorite editor, change the user (git) and home
|
|
(/home/git) settings to match the deployment environment. Change the PORT
|
|
or remove the -p flag if default port is used.
|
|
|
|
Lastly enable and start supervisor at boot:
|
|
```
|
|
sudo systemctl enable supervisor
|
|
sudo systemctl start supervisor
|
|
```
|
|
|
|
If you have systemd version 220 or later, you can enable and immediately start supervisor by:
|
|
```
|
|
sudo systemctl enable supervisor --now
|
|
```
|