---
title: Linux Service
sidebar_label: Linux Service
hide_title: false
hide_table_of_contents: false
---
# SRS Linux Service
There are many ways to startup SRS:
* Directly run srs at the trunk/objs, and need start again when system restart.
* Linux service, the init.d scirpt at `srs/trunk/etc/init.d/srs`, and user can add to linux service when linked to the /etc/init.d/srs then add as service `/sbin/chkconfig --add srs`.
The SRS release binary can be downloaded from release site, we can install as system service, see: [Github: release](http://ossrs.net/srs.release) or [Mirror for China: release](http://www.ossrs.net)
## Manual
We donot need to add to linux service to directly start SRS:
```bash
cd srs/trunk &&
./etc/init.d/srs start
```
or
```bash
cd srs/trunk &&
./objs/srs -c conf/srs.conf
```
## init.d
Install and startup SRS as linux system service:
* Build SRS: the install script will modify the INSTALL ROOT of init.d script.
* Link to init.d: link the `trunk/etc/init.d/srs` to `/etc/init.d/srs`
* Add to linux service: use /sbin/chkconfig for Centos.
Step1: Build and Install SRS
Intall SRS when build ok:
```bash
make && sudo make install
```
the install of make will install srs to the prefix dir, default to `/usr/local/srs`, which is specified by configure, for instance, ```./configure --prefix=`pwd`/_release``` set the install dir to _release of current dir to use `make install` without sudo.
Step2: Link script to init.d:
```bash
sudo ln -sf \
/usr/local/srs/etc/init.d/srs \
/etc/init.d/srs
```
Step3:Add as linux service:
```bash
#centos 6
sudo /sbin/chkconfig --add srs
```
or
```bash
#ubuntu12
sudo update-rc.d srs defaults
```
Use init.d script
Get the status of SRS:
```bash
/etc/init.d/srs status
```
Start SRS：
```bash
/etc/init.d/srs start
```
Stop SRS：
```bash
/etc/init.d/srs stop
```
Restart SRS：
```bash
/etc/init.d/srs restart
```
Reload SRS：
```bash
/etc/init.d/srs reload
```
For logrotate(`SIGUSR1`):
```bash
/etc/init.d/srs rotate
```
For Gracefully Quit(`SIGQUIT`):
```bash
/etc/init.d/srs grace
```
## systemctl
Ubuntu20 use systemctl to manage services, we also need to install init.d service, then add to systemctl:
```
./configure && make && sudo make install &&
sudo ln -sf /usr/local/srs/etc/init.d/srs /etc/init.d/srs &&
sudo cp -f /usr/local/srs/usr/lib/systemd/system/srs.service /usr/lib/systemd/system/srs.service &&
sudo systemctl daemon-reload && sudo systemctl enable srs
```
> Remark: We MUST copy the srs.service, or we couldn't enable the service by systemctl.
Use systemctl to start SRS:
```
sudo systemctl start srs
```
## Gracefully Upgrade
Gracefully Upgrade allows upgrade with zero downtime, it can be done by:
* New SRS and old SRS should be able to listen at the same ports. They provide services in the same ports simultaneously.
* The old SRS then closes listeners, and quit util all connections closed, this is Gracefully Quit.
> Note: About more informations, please see [#1579](https://github.com/ossrs/srs/issues/1579#issuecomment-587233844).
SRS3 supports Gracefully Quit:
* Use signal `SIGQUIT`, or command `/etc/init.d/srs grace`
* A new config `grace_start_wait` to wait for a while then start gracefully quit, default 2.3s
* A new config `grace_final_wait` allows wait for a few minutes finally, default 3.2s
* A new config `force_grace_quit` to force gracefully quit, see [#1579](https://github.com/ossrs/srs/issues/1579#issuecomment-587475077).
```bash
# For gracefully quit, wait for a while then close listeners,
# because K8S notify SRS with SIGQUIT and update Service simultaneously,
# maybe there is some new connections incoming before Service updated.
# @see https://github.com/ossrs/srs/issues/1595#issuecomment-587516567
# default: 2300
grace_start_wait 2300;
# For gracefully quit, final wait for cleanup in milliseconds.
# @see https://github.com/ossrs/srs/issues/1579#issuecomment-587414898
# default: 3200
grace_final_wait 3200;
# Whether force gracefully quit, never fast quit.
# By default, SIGTERM which means fast quit, is sent by K8S, so we need to
# force SRS to treat SIGTERM as gracefully quit for gray release or canary.
# @see https://github.com/ossrs/srs/issues/1579#issuecomment-587475077
# default: off
force_grace_quit off;
```
> Note: There is a example for Gracefully Quit, see [#1579](https://github.com/ossrs/srs/issues/1579#issuecomment-587414898)
Winlin 2019.10
