Web UI¶

Monitor and manage your data platform through a modern web interface.

Overview¶

The Dango Web UI provides a visual interface for managing your data platform. Access real-time sync monitoring, source management, data exploration, and system health checks through your browser at http://localhost:8800.

Key Features:

• Real-time monitoring with WebSocket updates
• Source management with sync triggers and CSV file uploads
• Data catalog with column profiling, lineage, and impact analysis
• Health dashboards for system status, disk usage, and OAuth tokens
• Notebook management for Marimo data exploration notebooks
• Authentication with role-based access, 2FA, and API keys

Getting Started¶

Launch Web UI¶

Start your Dango platform:

dango start

Open your browser:

http://localhost:8800

Log in with the admin credentials you set during dango init. On cloud deployments, use your server's domain (e.g., https://data.example.com).

First Steps¶

1. Check the dashboard — view service status and platform health
2. Browse your sources — see configured data sources and sync status
3. Trigger a sync — click Sync Now on a source to load data
4. Upload a CSV file — add files through the source detail modal
5. Explore the catalog — browse tables, columns, and lineage

Web UI Guides¶

Quick Actions¶

Common tasks via the Web UI:

Sync a Source¶

1. Go to the Sources page
2. Find the source in the table
3. Click the Sync Now button
4. Watch the status badge update in real time

Upload a CSV File¶

1. Go to the Sources page
2. Click on a CSV or local_files source
3. Use the file upload form in the modal to select files
4. Click Upload File, then Sync Now to process

Monitor Sync Progress¶

1. Watch toast notifications for sync start/complete events
2. Check the Dashboard for recent activity
3. Go to Logs for detailed event history
4. Filter by source or log level to find specific events

Check System Health¶

1. Go to the Health page from the gear menu
2. Review the status banner and metric cards
3. Check for sync or dbt failures in Recent Issues
4. Review OAuth token health for expiring credentials

Web UI vs CLI¶

The Web UI and CLI provide complementary interfaces to your Dango platform.

When to use Web UI:

• Visual monitoring and health dashboards
• Uploading CSV files via browser
• Exploring data catalog and lineage
• Quick ad-hoc sync triggers
• Managing notebooks

When to use CLI:

• Adding and configuring sources
• Managing schedules and users
• Automation and scripting
• CI/CD pipelines
• SSH access to remote servers

Use both together: Keep the Web UI open in a browser tab for monitoring while running CLI commands for configuration and automation.

Common Workflows¶

Morning Data Check¶

1. Open the Dashboard — check the health widget status
2. Review Recent Activity for overnight sync results
3. Go to Health if any warnings — check disk, OAuth tokens
4. Browse Sources — verify all sources synced successfully

Investigate a Sync Failure¶

1. Go to Sources — find the source with red status
2. Click the source to open the detail modal
3. Read the error message in the red alert box
4. Check Logs — filter by Error level and source name
5. Fix the issue (credentials, network, etc.) and click Sync Now

Explore Your Data¶

1. Open the Catalog — browse models and source tables
2. Use the search bar to find specific tables or columns
3. Click a model to view column profiles, tests, and SQL
4. Switch to the Lineage view to understand data flow
5. Click Query in the nav to open Metabase for SQL queries

Security¶

Authentication is enabled by default on both local and cloud deployments.

• Local: 365-day sessions, 24-hour idle timeout
• Cloud: 30-day sessions, 60-minute idle timeout, HTTPS via Caddy

Set up two-factor authentication for additional security, especially on cloud deployments. Create API keys for programmatic access.

Next Steps¶