37 lines
1.7 KiB
Markdown
37 lines
1.7 KiB
Markdown
# Advanced Post-installation Tasks
|
|
|
|
This page explains some advanced tasks and configuration options that can be performed after the bot installation and may be uselful in some environments.
|
|
|
|
If you do not know what things mentioned here mean, you probably do not need it.
|
|
|
|
## Configure the bot running as a systemd service
|
|
|
|
Copy the `freqtrade.service` file to your systemd user directory (usually `~/.config/systemd/user`) and update `WorkingDirectory` and `ExecStart` to match your setup.
|
|
|
|
!!! Note
|
|
Certain systems (like Raspbian) don't load service unit files from the user directory. In this case, copy `freqtrade.service` into `/etc/systemd/user/` (requires superuser permissions).
|
|
|
|
After that you can start the daemon with:
|
|
|
|
```bash
|
|
systemctl --user start freqtrade
|
|
```
|
|
|
|
For this to be persistent (run when user is logged out) you'll need to enable `linger` for your freqtrade user.
|
|
|
|
```bash
|
|
sudo loginctl enable-linger "$USER"
|
|
```
|
|
|
|
If you run the bot as a service, you can use systemd service manager as a software watchdog monitoring freqtrade bot
|
|
state and restarting it in the case of failures. If the `internals.sd_notify` parameter is set to true in the
|
|
configuration or the `--sd-notify` command line option is used, the bot will send keep-alive ping messages to systemd
|
|
using the sd_notify (systemd notifications) protocol and will also tell systemd its current state (Running or Stopped)
|
|
when it changes.
|
|
|
|
The `freqtrade.service.watchdog` file contains an example of the service unit configuration file which uses systemd
|
|
as the watchdog.
|
|
|
|
!!! Note
|
|
The sd_notify communication between the bot and the systemd service manager will not work if the bot runs in a Docker container.
|