# KV Synology — installed by the Synology package (one-click).

Your app is already running. To open it:
  - click the KV Synology icon in the DSM main menu (opens the app in a
    browser tab at http://<NAS-LAN-IP>:<port>/), or
  - Control Panel -> Application Portal -> KV Synology shows the address
    (a random free port between 20000-59999 is assigned automatically, so
    there are no port conflicts).

## What is KV Synology?

A modern Synology DSM web manager — Dashboard (CPU/RAM/Network/Disk realtime),
File Station (browse/create/upload/download/share), Docker/Container Manager,
Download Station, Storage Manager, etc. The browser talks directly to your
NAS via the Next.js proxy /api/dsm/[...path] (QuickConnect relay aware) —
no intermediate server.

## Login

On the KV Synology login screen, use:
  - LAN IP (192.168.x.x), DDNS (*.synology.me), or QuickConnect ID
    (your-id or your-id.quickconnect.to) — auto-resolved via
    global.quickconnect.to with relay fallback for NAS behind NAT
  - DSM user + password (OTP optional if enabled)

## Files & ports

The app is stateless — no volume is mounted. The assigned host port is stored
in /var/packages/kvsynology/etc/port_config (host_port=...). To change the
port, edit that file and reinstall/repair the package, or just reinstall.

## Uninstall (one click)

Package Center -> KV Synology -> Uninstall -> confirm.
The container is removed automatically. No persistent data to delete.

## Notes

- Firewall: if the DSM firewall is enabled, allow the app's port
  (Control Panel -> Security -> Firewall).
- Upgrades: an Update button appears in Package Center for new versions —
  your port is preserved.
- Reverse proxy: expose the app under your own domain via Control Panel ->
  Login Portal -> Advanced -> Reverse Proxy (source https://your.domain,
  destination http://127.0.0.1:<port>).
