Skip to main content

Admin Dashboard

EdgeBase ships with a built-in Admin Dashboard at /admin for local and production environments.

Access​

  • Local: http://localhost:8787/admin
  • Self-hosted: https://your-domain.com/admin
  • Edge deployment: https://your-project.edgebase.dev/admin

First Login​

  1. Start EdgeBase (npx edgebase init or npx edgebase dev — both open the dashboard automatically).
  2. Create the first admin account.
  3. Sign in and verify tables/users/storage views.

Admin password recovery is handled through the CLI, not by email. Use npx edgebase admin reset-password with a configured root Service Key when you need to recover an admin account.

Features​

Database Management​

  • Records (DataGrid): DataGrip-style inline cell editing with double-click to edit, column resizing, row selection with bulk delete, keyboard navigation (Arrow/Tab/Enter/Escape), dirty state tracking, and type-aware editors (text, number, boolean, JSON, datetime, enum).
  • SQL Console: Execute raw SQL queries against any namespace. Results displayed in a read-only DataGrid. Query history saved in localStorage (last 50 queries). Supports Ctrl/Cmd+Enter shortcut.
  • Schema ERD: SVG-based entity-relationship diagram showing tables, fields, and foreign key relationships. Color-coded by namespace (shared, workspace, user). Pan and zoom support.
  • Rules Test: Simulate access rule evaluation by selecting a user (or providing custom auth context) and testing read/insert/update/delete/access operations per table.
  • CSV Import/Export: Export records to CSV or import from CSV with column mapping UI, type inference, and preview.

Auth & Users​

  • Users: Browse, search, filter, and manage user accounts. Change roles, disable accounts, invalidate sessions.
  • Auth Settings: View OAuth provider configuration and email settings (read-only).

Storage​

  • Files: Browse R2 buckets, list files, view metadata, and delete objects.

Functions​

  • Functions UI: List all registered functions from config. Execute functions with custom HTTP method, JSON body, headers. View response status, body, and timing.

Analytics & Monitoring​

  • Analytics Overview: API traffic metrics with time series charts, category distribution, and top endpoints.
  • Event Timeline: Chronological timeline of auth events (signup, signin, signout, password reset) and custom events with type/time/user filtering.
  • Category Analytics: Dedicated dashboards for Auth, Database, Storage, and Functions metrics.
  • Logs: Request logs with prefix, level, and path filtering. Live mode with 2-second auto-refresh. Expandable JSON detail view.
  • Realtime Monitoring: Active WebSocket connections and channel subscriber counts.

System​

  • Settings: Environment overview showing dev/production mode, release status, database configurations, auth settings, storage buckets, and native resource bindings (KV, D1, Vectorize).
  • Onboarding: Getting-started checklist on the home dashboard with SDK connection code snippets (JavaScript, React, Vue) and progress tracking.

Security Notes​

  • Do not expose SERVICE_KEY in browser code.
  • Restrict admin access behind HTTPS and IP/network controls when self-hosting.
  • Rotate JWT_ADMIN_SECRET and SERVICE_KEY periodically.
  • For reverse proxies, keep WebSocket upgrade headers enabled.

Operational Checklist​

  • Admin account creation tested
  • /admin/api/* endpoints accessible with admin auth
  • Browser access forced to HTTPS in production
  • Backup schedule in place for self-hosted data