feat: use dedicated 'libretime' user

BREAKING CHANGE: The default `www-data` user has been replaced by a dedicated  `libretime` user to run the services. Be sure to change the ownership of the libretime files.
This commit is contained in:
jo 2022-07-06 16:21:40 +02:00 committed by Kyle Robbertze
parent 0bb792d047
commit 2f205544c2
16 changed files with 50 additions and 25 deletions

View file

@ -10,7 +10,7 @@ This page describe the available options to manage the LibreTime library.
To scan a directory and import the files into the library, you can use the following command:
```bash
sudo -u www-data libretime-api bulk_import --path PATH_THE_DIRECTORY_TO_SCAN
sudo -u libretime libretime-api bulk_import --path PATH_THE_DIRECTORY_TO_SCAN
```
See the command usage to get available options.

View file

@ -162,10 +162,10 @@ Feel free to run `./install --help` to get more details.
#### Using hardware audio output
If you plan to output analog audio directly to a mixing console or transmitter, the user running LibreTime (by default `www-data`) needs to be added to the `audio` user group using the command below:
If you plan to output analog audio directly to a mixing console or transmitter, the user running LibreTime needs to be added to the `audio` user group using the command below:
```bash
sudo adduser www-data audio
sudo adduser libretime audio
```
### Setup
@ -175,7 +175,7 @@ Once the installation is completed, edit the [configuration file](./configuratio
Next, run the following commands to setup the database:
```bash
sudo -u www-data libretime-api migrate
sudo -u libretime libretime-api migrate
```
Synchronize the new Icecast passwords into the database:

View file

@ -36,7 +36,7 @@ Be sure to carefully read **all** the [releases notes](../../releases/README.md)
Run the following command to apply the database migrations:
```bash
sudo -u www-data libretime-api migrate
sudo -u libretime libretime-api migrate
```
## Restart the services

View file

@ -49,7 +49,7 @@ On a common setup, to access LibreTime specific logs you should search for the f
For some LibreTime services, you can set a higher log level using the `LIBRETIME_LOG_LEVEL` environment variable, or by running the service by hand and using a command line flag:
```bash
sudo -u www-data libretime-analyzer --config /etc/libretime/config.yml --log-level debug
sudo -u libretime libretime-analyzer --config /etc/libretime/config.yml --log-level debug
```
The `/var/log/apache2/libretime.error.log` file contains logs from the web server.