Skip to content

Web Interface

The Raspi-Sump web interface is served over HTTPS by nginx and is accessible from any device on your local network.

https://<your-pi-ip>

!!! note "Self-signed certificate" The TLS certificate is self-signed. Your browser will show a security warning on first access. Accept the exception to proceed — this is expected behaviour for a LAN appliance.

The top navigation bar has three sections:

Item Description
Raspi-Sump Home page — today's readings and stats
History Historical readings with charts
Project Links to documentation, source code, and issue tracker
⚙ (gear icon) Admin panel — login required

Home Page

The home page displays today's water level activity:

  • Stat cards — reading count, minimum, maximum, and last recorded depth
  • Pit Empties — number of pump cycles detected today (shown when cycle detection is enabled)
  • Chart — interactive water level chart for today

The chart is rendered client-side using uPlot. Hover over the chart to see individual readings. The chart updates on page reload.

History

The History page shows readings for a specific date or custom date/time range.

Single Day

Select a date from the date picker and click View. The page displays:

  • Stat cards for the selected day
  • Pit Empties for the selected day (when cycle detection is enabled)
  • Interactive chart of all readings for that day

Custom Range

Select a start date and end date. Optionally add a start time and end time to narrow the range within those days. If no time is entered, the full day is used (midnight to 23:59).

Click View Range to display the chart.

Admin Panel

The admin panel is accessible via the ⚙ gear icon in the navigation bar. A login is required. The default password is set during the first-run setup wizard.

System Status

Displays the current status of the raspisump and rsumpweb services with colour-coded badges:

  • green — active and running
  • red — inactive or failed

Each service has Start, Stop, and Restart buttons. Restarting rsumpweb will briefly take the web interface offline and redirect you to a countdown page before reconnecting automatically.

The page also shows the last 20 lines of the service logs from the system journal.

Configuration

A form editor for all settings in raspisump.conf. Changes are validated before saving. After saving, restart the raspisump service for changes to take effect (a restart button is provided on the page).

Backup / Export

Downloads a zip file containing:

  • The SQLite database (raspisump.db)
  • The current raspisump.conf

Use this to back up your data before upgrades or when moving to a new Pi.

Import / Export CSV

Import: Upload one or more CSV files exported from Raspi-Sump 1.x. Duplicate entries are skipped automatically.

Export: Select a date range and download readings as a CSV file (single day) or a zip of CSV files (multiple days).

Security

Manage credentials stored in credentials.conf:

  • Change the admin password
  • Update SMTP credentials
  • Update Mastodon credentials

After saving changes, restart the rsumpweb service for credential changes to take effect (a restart button is provided on the page).

Logout

Click the ⚙ gear icon and select Logout to end your admin session.

Dark Mode

A dark mode toggle is available in the navigation bar. Your preference is saved in the browser and applied on subsequent visits.