diff --git a/docs/content/doc/installation/run-as-service-in-ubuntu.en-us.md b/docs/content/doc/installation/run-as-service-in-ubuntu.en-us.md index d3b5df5b5af..7af062c3aa4 100644 --- a/docs/content/doc/installation/run-as-service-in-ubuntu.en-us.md +++ b/docs/content/doc/installation/run-as-service-in-ubuntu.en-us.md @@ -13,16 +13,13 @@ menu: identifier: "linux-service" --- -### Run as service in Ubuntu 16.04 LTS +### 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 -Run the below command in a terminal: -``` -sudo vim /etc/systemd/system/gitea.service -``` - -Copy the sample [gitea.service](https://github.com/go-gitea/gitea/blob/master/contrib/systemd/gitea.service). +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. @@ -35,6 +32,10 @@ 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 @@ -49,19 +50,20 @@ Create a log dir for the supervisor logs: mkdir /home/git/gitea/log/supervisor ``` -Open supervisor config file in a file editor: -``` -sudo vim /etc/supervisor/supervisord.conf -``` - Append the configuration from the sample -[supervisord config](https://github.com/go-gitea/gitea/blob/master/contrib/supervisor/gitea). +[supervisord config](https://github.com/go-gitea/gitea/blob/master/contrib/supervisor/gitea) to `/etc/supervisor/supervisord.conf`. -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. +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 +```