> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ditto.live/llms.txt
> Use this file to discover all available pages before exploring further.

# Edge Server Release Notes

<Warning>
  Edge Server is currently in preview with nightly builds. These release notes track significant changes and improvements as the product evolves toward stable release.
</Warning>

## Preview Releases

Edge Server is released nightly during the preview period. Each build includes the latest features, improvements, and bug fixes.

As this is a preview release, breaking changes may occur between nightly builds. Always review the configuration schema when updating.

## Recent Updates

### March 2026 - Latest Preview Features

#### New HTTP API Endpoints

* **POST `/execute`**: Execute DQL (Ditto Query Language) statements through the HTTP API
* **POST `/attachments/upload`**: Upload attachments to devices running Ditto SDK (small peer)
* **GET `/attachments/{id}`**: Download attachments from devices running the Ditto SDK (small peer)
* **GET `/presence`**: View the presence graph of peers on the edge server
* **GET `/logs`**: Download comprehensive logs as a `.tar.gz` file (includes both Ditto SDK logs and edge server application logs)
* **GET `/docs`**: Access Edge Server HTTP API documentation directly from the server

#### Security & Authentication

* **HTTPS Support**: Full TLS 1.2 and TLS 1.3 support for secure communications
* **API Key Authentication**: Generate and manage API keys for client authentication via CLI
* **Identity Resource**: New identity resource type in YAML configuration
* **Permission-Based Access Control**: Operation-based permissions for fine-grained request authorization
* **Access Audit Logging**: Comprehensive audit log collection and retrieval for compliance

#### Performance & Reliability

* **HTTP Request Throttling**: Configure rate limiting to protect server resources
* **HTTP Server Limits**: Enforceable limits on a per-endpoint basis
* **Request Timeouts**: Configurable HTTP request timeout settings
* **TCP Keepalive**: TCP keepalive configuration for connection health
* **Connection Limits**: Configurable TCP connection and backlog limits

#### Configuration Improvements

* **DittoDatabase Resource**: New resource type for database configuration
* **DittoSubscription Resource**: New resource type for subscription management
* **CLI Commands**: Enhanced CLI for config operations and running the edge server
* **Rotating Log Files**: Configurable rotating log file support

### August 20, 2025

* **Enhanced Configuration**: Improved transport configuration options for mesh networking
* **Persistence Management**: Better control over data directory locations
* **Logging Improvements**: Configurable log levels
* **HTTP API**: Full HTTP API support for querying and manipulating data
* **Cloud Sync**: Connect to Ditto Cloud or self-hosted Ditto Server
* **Small Peers Mode**: Operate in offline-only mode with local mesh networking
* **Docker Support**: Official Docker images for containerized deployments

## Known Limitations

During the preview period, the following limitations apply:

* API may change based on feedback
* Not recommended for production use
* Limited platform support (Linux x86\_64 and arm64 only for native builds)
* Some advanced features from the full SDK may not be available
* Network transports are configured declaratively

## Providing Feedback

As you test Edge Server, please provide feedback through:

* Your Ditto account representative
* Support tickets through the Ditto Portal

## Coming Soon

Planned features for upcoming releases:

* Additional authentication providers beyond API keys
* Enhanced monitoring and metrics dashboards
* Extended platform support (macOS, Windows)
* Performance optimizations for resource-constrained environments
* Advanced querying capabilities

***

*Note: This document will be updated as new preview releases become available. Check back regularly for the latest information.*