2017-11-26 21:44:32 +00:00
---
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"
---
2020-01-08 16:33:13 +00:00
### Run Gitea as Linux service
2017-11-26 21:44:32 +00:00
2020-01-08 16:33:13 +00:00
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).
2018-01-08 22:48:42 +00:00
2020-01-08 16:33:13 +00:00
#### Using systemd
2017-11-26 21:44:32 +00:00
2020-01-08 16:33:13 +00:00
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.
2017-11-26 21:44:32 +00:00
2018-01-08 22:48:42 +00:00
Uncomment any service that needs to be enabled on this host, such as MySQL.
2017-11-26 21:44:32 +00:00
2018-01-08 22:48:42 +00:00
Change the user, home directory, and other required startup values. Change the
PORT or remove the -p flag if default port is used.
2017-11-26 21:44:32 +00:00
2019-03-09 21:15:45 +00:00
Enable and start Gitea at boot:
2017-11-26 21:44:32 +00:00
```
2018-01-08 22:48:42 +00:00
sudo systemctl enable gitea
2017-11-26 21:44:32 +00:00
sudo systemctl start gitea
```
2020-01-08 16:33:13 +00:00
If you have systemd version 220 or later, you can enable and immediately start Gitea at once by:
```
sudo systemctl enable gitea --now
```
2017-11-26 21:44:32 +00:00
2018-01-08 22:48:42 +00:00
#### Using supervisor
2017-11-26 21:44:32 +00:00
2018-01-08 22:48:42 +00:00
Install supervisor by running below command in terminal:
2017-11-26 21:44:32 +00:00
```
sudo apt install supervisor
2018-01-08 22:48:42 +00:00
```
2017-11-26 21:44:32 +00:00
2018-01-08 22:48:42 +00:00
Create a log dir for the supervisor logs:
2017-11-26 21:44:32 +00:00
```
2019-03-09 21:15:45 +00:00
# assuming Gitea is installed in /home/git/gitea/
2017-11-26 21:44:32 +00:00
mkdir /home/git/gitea/log/supervisor
2018-01-08 22:48:42 +00:00
```
2017-11-26 21:44:32 +00:00
2018-01-08 22:48:42 +00:00
Append the configuration from the sample
2020-01-08 16:33:13 +00:00
[supervisord config ](https://github.com/go-gitea/gitea/blob/master/contrib/supervisor/gitea ) to `/etc/supervisor/supervisord.conf` .
2017-11-26 21:44:32 +00:00
2020-01-08 16:33:13 +00:00
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.
2017-11-26 21:44:32 +00:00
2018-01-08 22:48:42 +00:00
Lastly enable and start supervisor at boot:
2017-11-26 21:44:32 +00:00
```
2018-01-08 22:48:42 +00:00
sudo systemctl enable supervisor
2017-11-26 21:44:32 +00:00
sudo systemctl start supervisor
```
2020-01-08 16:33:13 +00:00
If you have systemd version 220 or later, you can enable and immediately start supervisor by:
```
sudo systemctl enable supervisor --now
```