# 7. Database Explorer

Address: http://localhost:55000/database

Use this page when you need to inspect what TotumService thinks about files and uploads — especially for stuck or failed work.

# Summary cards

# Tracked Files tab

Shows the folder monitor’s view of each file.

# Filters

• State — Detected, Stable, Uploading, Uploaded, Failed, Failed Permanent
• Folder — folder configuration name
• Search — path text
• Errors Only — focus on problems

# How to read a row

• File Name / path — what was found
• Folder — which monitor owns it
• State — where it is in the lifecycle
• Detected — when it was first seen
• Attempts — how many upload tries

# State reminder

Detected → Stable → Uploading → Uploaded
                         ↘ Failed → retry or Failed Permanent

# Transfers tab

Shows low-level transfer jobs (the coordinator’s view).

Useful when:

• A file is “Uploading” for a long time
• You need provider name, progress, or duration
• You are correlating with Active Transfers on the dashboard

Cancel in-flight work from the main dashboard, not always from this page.

# Recent Failures tab

A focused list of files that failed after retries.

What to do

1. Read the Error text carefully.
2. Common causes: network blips, wrong bucket name, missing permissions, file deleted before upload finished, provider disabled.
3. Fix the underlying issue.
4. Transient failures often retry automatically; permanent failures need a config or environment fix, then often a new file drop or manual operational follow-up.

# Export

Use Export CSV when you need to share a snapshot with support or keep an offline record.

Use Refresh after making config changes or waiting for a scan cycle.

# When to use Dashboard vs Database Explorer

# Next step

Managing the Service →