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