# Rclone WebDAV Configuration and Auto-Mount Guide for Copyparty

## 1. Configure the Rclone Remote

Do not pass complex passwords via command-line arguments. Use the interactive configuration wizard to avoid shell parsing errors.

Run the configuration wizard:
```bash
rclone config
```

Follow these prompts:
1. Type `n` for **New remote**.
2. Enter a name: `cpppoeticpantherboxca-dav`
3. Select the number for **WebDAV**.
4. Enter the URL: `https://cpp.poeticpanther.box.ca/media`
5. Enter the vendor: `owncloud`
6. Enter the user: `k`
7. For the password, type `y` to **Yes type in my own password**.
8. Paste your password. (It will be hidden).
9. Leave the bearer token blank.
10. Complete the setup and exit.

## 2. Prepare the Mount Point

Create the directory and take ownership so your standard user can write to it.

```bash
sudo mkdir -p /mnt/copybox
sudo chown tyler:tyler /mnt/copybox
```

Enable `allow_other` in FUSE so background services can access the mount.
Open `/etc/fuse.conf` as root and uncomment this line:
```text
user_allow_other
```

## 3. Create the Systemd Service

Using a systemd service is the most reliable way to mount rclone on boot. The configuration below defines network dependencies and uses `Restart=on-failure` to prevent the system from hanging if the remote endpoint goes down.

Create a new service file:
```bash
sudo nano /etc/systemd/system/mnt-copybox.service
```

Paste the following configuration:

```ini
[Unit]
Description=Rclone Mount for Copyparty WebDAV
Wants=network-online.target
After=network-online.target

[Service]
Type=notify
Environment=RCLONE_CONFIG=/home/tyler/.config/rclone/rclone.conf
ExecStart=/usr/bin/rclone mount cpppoeticpantherboxca-dav: /mnt/copybox \
  --vfs-cache-mode writes \
  --dir-cache-time 5s \
  --allow-other
ExecStop=/bin/fusermount -uz /mnt/copybox
Restart=on-failure
RestartSec=10
User=tyler
Group=tyler

[Install]
WantedBy=default.target
```

## 4. Enable and Start the Service

Reload the systemd daemon to register the new service:
```bash
sudo systemctl daemon-reload
```

Start the mount immediately:
```bash
sudo systemctl start mnt-copybox.service
```

Verify it is running and check for errors:
```bash
systemctl status mnt-copybox.service
```

Enable the service to run automatically on system boot:
```bash
sudo systemctl enable mnt-copybox.service
```