-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
add arch linux installation instructions
- Loading branch information
1 parent
79d6838
commit 3239b82
Showing
5 changed files
with
77 additions
and
36 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,40 @@ | ||
--- | ||
id: archlinux | ||
title: Arch Linux Install | ||
pagination_prev: install/choosemethod | ||
pagination_next: install/configuration | ||
description: Install Unpackerr on an Arch Linux server. | ||
--- | ||
|
||
import ArchiveAccess from './includes/archiveaccess.md'; | ||
import Permissions from './includes/linuxpermissions.md'; | ||
|
||
:::info Root Access | ||
This installation method requires root. If you don't have root on your shell, | ||
then check out the <a href="/docs/install/seedbox">non-root directions</a>. | ||
::: | ||
|
||
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](https://github.com/Unpackerr/unpackerr/releases/latest) | ||
and install it with `pacman -U <file or url>`. Alternatively, you can build | ||
it yourself using the [public AUR](https://aur.archlinux.org/packages/unpackerr). | ||
|
||
If you don't want to bother figuring out which file you need, use the | ||
[install.sh](https://github.com/Unpackerr/unpackerr/blob/main/init/install.sh) script. | ||
It downloads and trusts the [GoLift GPG public key](https://golift.io/gpg) and then | ||
installs the binary Unpackerr package in one command, like this: | ||
|
||
```shell | ||
# 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. | ||
|
||
<ArchiveAccess /> | ||
|
||
## Permissions | ||
|
||
<Permissions /> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,26 @@ | ||
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` | ||
1. The previous command opens your `$EDITOR` with a commented out version of the unpackerr service unit. | ||
1. Add the following content to the file editor between the comments. | ||
Replace `newuser` and `newgroup` with your new values. | ||
```systemd | ||
[Service] | ||
User=newuser | ||
Group=newgroup | ||
``` | ||
1. Run this to read the new systemd service override file: | ||
- `sudo systemctl daemon-reload` | ||
1. Run this to start unpackerr with the new user and group: | ||
- `sudo systemctl restart unpackerr` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters