# Service Setup Guide: Portracker

Portracker is a real-time port monitoring and service discovery tool.

## 1. Pre-Setup (Manual)
### Create Service User
- [ ] **Manual**: Create a local user named `svc-portracker` in Synology DSM (Control Panel > User & Group).
- [ ] **Manual**: Give this user read/write access to the `docker` shared folder.

### Get User IDs
- [ ] **Manual**: SSH into your NAS and run `id svc-portracker`.
- [ ] **Action**: Record the `uid` (PUID) and `gid` (PGID) for use in Portainer.

## 2. Infrastructure Setup
### Run Setup Script
- [ ] **Action**: Run the setup script to initialize the data directory:
  ```bash
  sudo bash create_portracker_folders.sh
  ```
- **What it does**: 
  - Creates `/volume1/docker/portracker/data`.
  - Sets ownership to the `svc-portracker` user (Note: You may need to edit the script with your specific PUID/PGID before running).

## 3. Portainer Deployment
### Environment Variables
- [ ] **Action**: In the Portainer Stack configuration, add the following environment variables:
  - `PUID=[Your UID]`
  - `PGID=[Your GID]`
  - `TZ=[Your Timezone, e.g., America/Toronto]`

### Deploy Stack
- [ ] **Action**: Create a new stack named `portracker`.
- [ ] **Action**: Paste the content of `docker-compose.portainer.yml` and deploy.
- [ ] **Verification**: Access the dashboard at `http://[NAS_IP]:4999`.

> [!NOTE]
> This service requires access to the Docker socket and host PID to monitor network services. It runs with elevated capabilities (`SYS_PTRACE`, `SYS_ADMIN`).