Add more detailed installation instructions

Add example systemd service
merge-requests/1/merge
knotteye 2019-10-20 16:30:23 -05:00
parent 7ca1e9023c
commit 8771411352
4 changed files with 59 additions and 1 deletions

View File

@ -19,8 +19,9 @@ saltRounds = 12
[ircd] [ircd]
enable = true enable = true
#enable IRC peering #enable IRC peering
#unused for now
``` ```
### Web Frontend ### Web Frontend
If you want to customize the front-end css, place a file with any changes you wish to make at site/local.css If you want to customize the front-end css, place a file with any changes you wish to make at site/local.css
You can change the logo by replacing site/logo.svg, or edit templates/base.njk to look for another source. You can change the logo by replacing site/logo.svg.

35
docs/INSTALLATION.md Normal file
View File

@ -0,0 +1,35 @@
## Installing Satyr
A more detailed walkthrough.
### System Dependencies
Install ffmpeg and mysql through your distribution's package manager.
See [this page](https://nodejs.org/en/download/package-manager/) for instructions on install node. Compatible versions are >=10. Nightly builds may fail to compile some of the native addons.
### Installing Satyr
Clone the repository and change to the directory
```bash
git clone https://gitlab.com/knotteye/satyr.git
cd satyr
```
Install nodejs dependencies
```bash
npm install
```
Run the setup script to generate a config file and database setup.
```bash
npm run setup
```
Look over the generated config file in config/generated.toml, and move it to config/local.toml when you're satisfied.
Run the setup script for the database.
```bash
sudo mysql
source install/db_setup.sql;
```
Compile the code and start the server.
```bash
npm run build
npm start
```
It is reccomended that you run Satyr behind a TLS terminating reverse proxy, like nginx.
An example systemd service is provided at install/satyr.service. It assumes you've installed satyr into /opt/satyr, and created a satyr user with the home directory /var/lib/satyr for the purpose of running the service.

View File

@ -10,6 +10,7 @@ npm install
npm run setup npm run setup
npm run build npm run build
``` ```
Follow the instructions after setup runs.
### Run the server ### Run the server
```bash ```bash

21
install/satyr.service Normal file
View File

@ -0,0 +1,21 @@
[Unit]
Description=A livestreaming server.
After=network.target
[Service]
ExecReload=/bin/kill $MAINPID
KillMode=process
Restart=on-failure
User=satyr
Environment="HOME=/var/lib/satyr"
WorkingDirectory=/opt/satyr
ExecStart=/usr/bin/npm start
PrivateTmp=true
ProtectHome=true
ProtectSystem=full
NoNewPrivileges=true
[Install]
WantedBy=multi-user.target