# 4. Using the Dashboard
Address: http://localhost:55000
The dashboard is your live overview of TotumService. It is designed for the PC where the service runs.
# Top navigation
| Control | What it does |
|---|---|
| Database | Opens Database Explorer (tracked files & transfers) |
| Configuration | Opens folders, providers info, and settings |
| API Docs | Opens Swagger documentation for the REST API |
| Auto-Refresh | Turns periodic refresh on or off |
| Refresh Now | Reloads all dashboard sections immediately |
# Status cards
At the top you typically see:
- Status — overall health
- Uptime — how long the service has been running
- Plugins — how many plugins are loaded
- Active Transfers — uploads currently in flight or queued
If status is unhealthy, check Recent Logs and Troubleshooting.
# Active Transfers
Shows uploads that are queued or running.
What you can do
- Watch progress
- Cancel a transfer if it must be stopped
Cancelling stops that transfer job. The folder monitor may still know about the file and may retry later, depending on state and settings.
# Transfer Providers
Lists storage backends (for example S3).
| Indicator | Meaning |
|---|---|
| Available / healthy | Provider can accept work |
| Disabled | You (or config) turned it off — new transfers are rejected |
| Unhealthy | Connectivity or configuration problem |
Use the toggle to enable or disable a provider. Credentials are not edited here; they live in appsettings — see Advanced.
# System Metrics
CPU, memory, and thread charts for the service process. Spikes during large uploads are normal. Sustained high CPU with no uploads may warrant a log check.
# Recent Logs
A live buffer of recent log lines.
Tips:
- Filter by level (Debug, Info, Warning, Error)
- Search for a file name, transfer ID, or bucket name
- Prefer Error / Warning when diagnosing failures
Full history also goes to log files under the service logs folder (if file logging is enabled) and Windows Event Log in production.
# Plugins
Each plugin shows name, description, and health. Unhealthy plugins often explain why uploads or monitoring stopped working.
# Database Files
Lists the SQLite databases TotumService uses and rough sizes. Useful to confirm the service is writing state where you expect.
For file-level detail, open Database Explorer.
# Orientation tip
First time on a new install:
- Confirm status is healthy.
- Confirm S3 (or your provider) is available.
- Open Configuration and set up folders.
- Drop a small test file and watch Active Transfers.
- Confirm the file appears as Uploaded in Database Explorer.