Skip to main content
Edge Server is currently in preview. It is not recommended for production use.Edge server is under rapid development as a result:
  • APIs may change without notice.
  • Configuration format may change without notice.
  • Features, and behavior may change without notice.
  • This documentation may quickly grow stale or become inaccurate.
If you are experiencing issues, please reach out to your Ditto contact.
Ditto Edge Server is a lightweight, standalone database server that enables real-time data synchronization across devices in offline-first and edge computing environments. Built on the Ditto platform, Edge Server allows you to:
  • Deploy on resource-constrained devices like Raspberry Pi, industrial gateways, or IoT hubs
  • Synchronize data locally between nearby devices using Wi-Fi, Bluetooth, or LAN without internet connectivity
  • Expose a REST API so web browsers and HTTP clients can interact with the synchronized database
  • Bridge to the cloud by syncing with remote Ditto servers when internet connectivity is available
Edge Server is ideal for scenarios where you need data access at the network edge—retail stores, healthcare facilities, field operations, or any environment where low-latency access and offline resilience are critical.

​
Key Features

​
1. REST API for Universal Access

An HTTP interface that allows any client—web browsers, mobile apps, backend services—to query and modify data. Execute queries using Ditto Query Language (DQL), upload/download file attachments, and monitor server health through standard REST endpoints.

​
2. Local Peer-to-Peer Sync

Mobile and desktop applications using the Ditto SDK can automatically discover and sync with Edge Server over Wi-Fi, Bluetooth, or LAN. Devices form a mesh network that continues working even when disconnected from the internet.

​
3. Cloud Synchronization

When internet connectivity is available, Edge Server can sync data bidirectionally with Ditto Cloud or other Ditto Server instances using WebSocket-based replication. This creates a hybrid architecture where data flows between edge locations and centralized cloud infrastructure.

​
4. Multi-Server Replication

Connect multiple Edge Servers together to create redundancy and distribute data across locations. One server can act as a backup for another, or multiple servers can stay synchronized to serve different geographic areas.

​
5. Automatic Conflict Resolution

When the same data is modified on multiple devices simultaneously, conflicts are resolved automatically at the field level—meaning individual properties of a document can be merged intelligently without losing updates. See Conflict Resolution for details on how this works.

​
6. Enterprise Security

Production-ready security features including HTTPS/TLS encryption, API key-based authentication, granular permission controls, and comprehensive audit logging to track all data access.

​
7. Monitoring & Diagnostics

Built-in tools to understand system health: view which devices are connected (presence graph), download server logs for troubleshooting, and explore the auto-generated OpenAPI documentation.

​
Preview Release

Edge server is a preview release, with updates released nightly. Preview releases offer early access to features and improvements that are approaching maturity but still undergoing development. These releases are intended for gathering user feedback and testing integration with existing workflows. The API likely will change based on feedback and ongoing development. While in the preview stage, Edge Server is not recommended for production use.

​
Next Steps

  1. Quickstart: Follow the installation guides to set up a local development environment for testing and integration.
  2. Install Guide: Familiarize yourself with the Edge Server API documentation.
  3. Roadmap & Compatibility: Understand the current roadmap and compatibility with Ditto Edge SDK versions.
  4. Provide Feedback: As you test the Edge Server, provide feedback on your experience to help improve the product.