Skip to main content

Installation via Python pip

Instructions​

python3 -m pip install unmanic

Running Unmanic​

To run unmanic, simply run:

unmanic

By default Unmanic's WebUI will be accessable on port 8888. You can change this by adding the --port flag.

For more information run:

unmanic --help

Automatically start Unmanic​

You may wish to automatically start Unmanic when your system starts.

This example leverages systemd's userspace in order to be aligned with the install instructions documented above.

sudo mkdir -p /opt/unmanic
sudo chown $(id -u) /opt/unmanic
mkdir -p ~/.config/systemd/user

cat << EOF > ~/.config/systemd/user/unmanic.service
[Unit]
Description=Unmanic - Library Optimiser
After=network-online.target
StartLimitInterval=200
StartLimitBurst=3

[Service]
Type=simple
Environment="HOME_DIR=/opt/unmanic"
WorkingDirectory=/opt/unmanic
ExecStart=%h/.local/bin/unmanic
Restart=always
RestartSec=30

[Install]
WantedBy=default.target
EOF

systemctl --user enable unmanic.service
systemctl --user start unmanic.service

You can view the status of the running process

systemctl --user status unmanic.service

You can view the logs

journalctl --user -u unmanic.service