deluge/docs/source/how-to/launchd-service.md
Calum Lind 24aa48187e [Docs] Replace recommonmark with MyST parser
We used recommonmark so that we can use markdown in sphinx but it is
buggy and now so switch to better supported MyST-parser.

* Fixed incorrect heading warnings in markdown.
* Added sphinx toctree to markdown using directive as required by MyST.
* Upgraded Sphinx to 4.3

Ref: https://myst-parser.readthedocs.io
2021-12-12 18:16:21 +00:00

1.5 KiB
Raw Blame History

How to create launchd services for macOS

The following launchd script uses a separate user deluge, this is optional but recommended for security. To create a new deluge user follow the Apple help steps.

The paths to deluged and deluge-web assumes installation using Homebrew and will need modified if using other installation methods e.g. Deluge.app.

Daemon (deluged) service

Create the file /Library/LaunchDaemons/org.deluge-torrent.deluged.plist containing the following:

.. literalinclude:: ../../../packaging/osx/launchd/org.deluge-torrent.deluged.plist
    :language: xml

Set the service to load on startup and then start it:

sudo launchctl load -w /Library/LaunchDaemons/org.deluge-torrent.deluged.plist
sudo launchctl start org.deluge-torrent.deluged

Web UI (deluge-web) service

Create the file /Library/LaunchDaemons/org.deluge-torrent.deluge-web.plist containing the following:

.. literalinclude:: ../../../packaging/osx/launchd/org.deluge-torrent.deluge-web.plist
    :language: xml

Set the service to load on startup and then start it:

sudo launchctl load -w /Library/LaunchDaemons/org.deluge-torrent.deluge-web.plist
sudo launchctl start org.deluge-torrent.deluge-web

Logging

Logging is enabled by default in the above script, error level, and can be modified as required.