more updaes

Author: davidnewhall

docs/install/compose.md

@@ -77,6 +77,7 @@ Replace `/downloads/unpackerr.log` with `/data/unpackerr.log` if you mounted `/d
 Or whatever download path you mounted; just put it there for ease of finding it.
 
 # More Notes
+
 :::warning Security Opts
 Do not include this in your compose. It will make Unpackerr not work properly. If you know how
 to adjust caps, go for it, but please don't ask for help without removing this first:
@@ -99,4 +100,4 @@ folder on the left side.
 ```yaml
     volumes:
       - /mnt/appdata/unpackerr:/config
-```
+```

docs/install/freebsd.md

@@ -9,11 +9,16 @@ description: Install Unpackerr on a FreeBSD server.
 import ArchiveAccess from './includes/archiveaccess.md';
 
 1. Download a package from the [Releases](https://github.com/Unpackerr/unpackerr/releases) page.
-1. Install it, edit config, start it.
+1. Install it with `pkg add -f` (the force flag is required because the package has
+   [a bug](https://github.com/Unpackerr/unpackerr/issues/352))
+1. Edit the config file at `/etc/unpackerr/unpackerr.conf`,
+   or [generate one](https://notifiarr.com/unpackerr.php) and start it.
 1. Not many folks use FreeBSD, but we can try to help if you drop by the [Discord](https://golift.io/discord).
 
 <ArchiveAccess />
 
 ## Permissions
 
-On FreeBSD the app runs as `nobody`. That's not very good and will probably change in the future.
+On FreeBSD the app runs as user `nobody`. That's not very good and will probably change in the future.
+If you know how to change it, please
+[let me know](https://github.com/Unpackerr/unpackerr/issues/new) so we can update this page.

docs/install/includes/archiveaccess.md

@@ -1,5 +1,5 @@
 :::caution Archive Access
-Requires access to your download location.
+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

docs/install/linux.md

@@ -26,7 +26,8 @@ unpackerr in one command.
 curl -s https://golift.io/repo.sh | sudo bash -s - unpackerr
 ```
 
-After install, edit the config file and start the service:
+After install, edit the config file, or
+[generate one](https://notifiarr.com/unpackerr.php) and start the service:
 
 ```shell
 sudo nano /etc/unpackerr/unpackerr.conf
@@ -42,20 +43,27 @@ user or group read and write access to your archives. That may mean adding the `
 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. Make this folder: `sudo mkdir -p /etc/systemd/system/unpackerr.service.d/`
-1. Make this file: `sudo touch /etc/systemd/system/unpackerr.service.d/override.conf`
+1. Make this folder:
+   - `sudo mkdir -p /etc/systemd/system/unpackerr.service.d/`
+1. Make this file:
+   - `sudo touch /etc/systemd/system/unpackerr.service.d/override.conf`
 1. Add the following content to the file. Replace `newuser` and `newgroup` with your new values.
    ```systemd
    [Service]
    User=newuser
    Group=newgroup
    ```
-1. Run `sudo systemctl daemon-reload` to re-read this new config file.
-1. Run `sudo systemctl restart unpackerr` to start unpackerr with the new ID(s).
+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`
 
 ---
 

docs/install/macos.md

@@ -8,30 +8,9 @@ description: Install Unpackerr on a macOS system.
 
 import ArchiveAccess from './includes/archiveaccess.md';
 
-## Brew
-
-1. Use homebrew.
-1. Edit config file at `/usr/local/etc/unpackerr/unpackerr.conf`
-1. Start it.
-1. Like this:
-
-```shell
-brew install golift/mugs/unpackerr
-vi /usr/local/etc/unpackerr/unpackerr.conf
-brew services start unpackerr
-```
-
-The `brew services start` command will signal brew to start Unpackerr every time you login.
-
 <ArchiveAccess />
 
-## App
-
-You can also use a GUI app on a Mac instead of CLI via Homebrew:
-
-:::info brew vs app
-The `.app` and the Homebrew version are the same application, but one runs in GUI mode and one does not.
-:::
+## Universal Binary App
 
 1. Download a `.dmg` file from
    [the Releases page](https://github.com/Unpackerr/unpackerr/releases) and double-click it.

docs/install/windows.md

@@ -15,15 +15,16 @@ A default Windows install runs from `C:\`; if you installed Windows in another l
 :::
 
 - Browse to `C:\ProgramData` and create a folder named `unpackerr` and then inside that create a `logs` directory.
-  - Enable hidden files and folders if you dont see `C:\ProgramData`.
+  - Enable hidden files and folders if you don't see `C:\ProgramData`.
   - End result: `C:\ProgramData\unpackerr` and `C:\ProgramData\unpackerr\logs`
 - Extract a `.exe.zip` file from [the Releases page](https://github.com/Unpackerr/unpackerr/releases)
   into  `C:\ProgramData\unpackerr\`.
 - Run the `unpackerr.amd64.exe` binary. This starts the app in the system tray.
 - Click the systray icon and select `Config` -> `Edit`.
 - Uncomment `log_file` (remove the `#`) and set it as shown here:
   - `log_file = 'C:\ProgramData\unpackerr\logs\unpackerr.log'`
-- Edit the rest of the config to suit your system and save the file.
+- Edit the rest of the config to suit your system,
+  or [generate one](https://notifiarr.com/unpackerr.php) and save the file.
 - Click the systray icon again and select `Quit`. Then open the app again.
 - View the logs by clicking the systray icon and `Logs` -> `View`.
 - Make a shortcut to the application in your Startup menu to run it when you login.