Skip to main content

Arch Linux Install

Root Access

This installation method requires root. If you don't have root on your shell, then check out the non-root directions.

Arch does not use a repository, so binary packages are built and uploaded to GitHub for each release. Download the zst package for your architecture from the releases page and install it with pacman -U <file or url>. Alternatively, you can build it yourself using the public AUR.

Automatically

If you don't want to bother figuring out which file you need, use the install.sh script. It downloads and trusts the GoLift GPG public key and then installs the binary Unpackerr package in one command, like this:

# Pick curl or wget. Run only one of these:
curl -sL https://raw.githubusercontent.com/Unpackerr/unpackerr/main/init/install.sh | sudo bash
wget -qO- https://raw.githubusercontent.com/Unpackerr/unpackerr/main/init/install.sh | sudo bash

You can run this script any time to update to the latest version. Run it weekly in cron to keep up to date automatically.

Archive Access

Unpackerr requires write access to your download location. Make sure you set the path variables correctly in the configuration. Even if they're set incorrectly Unpackerr makes a best effort attempt to locate your downloads. If it can't find your downloads, then the path or paths variables need to be adjusted.

Permissions

On Linux, unpackerr runs as user:group unpackerr:unpackerr. You will need to give that user or group read and write access to your archives. That may mean adding the unpackerr user, for example, to the debian-transmission group. You would do that with a command such as sudo usermod -aG debian-transmission unpackerr

It's only suggested you do run usermod if you know what it does and how to set a umask. You probably instead want to change the uid and/or gid as shown next.

Change the uid/gid

If you wish to change the user and/or group that unpackerr runs as you need to do exactly this, and only this:

  1. Run this command:
    • sudo systemctl edit unpackerr.service
  2. The previous command opens your $EDITOR with a commented out version of the unpackerr service unit.
  3. Add the following content to the file editor between the comments. Replace newuser and newgroup with your new values.
    [Service]
    User=newuser
    Group=newgroup
  4. Run this to read the new systemd service override file:
    • sudo systemctl daemon-reload
  5. Run this to start unpackerr with the new user and group:
    • sudo systemctl restart unpackerr