Install BlueZ package version 5.66 or higher. The BlueZ package is the official Linux stack and provides all the modules you’ll need to enable data sync with Bluetooth Low Energy (LE). 

Add support for Linux to iOS connections.

BlueZ 5.51 and above try to automatically read the battery status/service of devices when they connect. However, iOS devices will default prevent BlueZ services from reading the battery service. As a result, BlueZ connection attempts will cause iOS devices to show a pairing prompt constantly. Therefore, we must disable the battery service in BlueZ using the following steps.

to apply changes to the Bluetooth service. 

5. Linux’s Bluetooth system aggressively prefers classic Bluetooth (BR/EDR) mode when it encounters a Mac - this results in both the pairing popups and intermittent sync. Before running your app, you can prevent this with a little Bluetooth configuration on your Linux machines.

After that, BlueZ should be able to connect to iOS devices without prompting and Ditto Apps should be able to communicate over BT-LE between iOS and Linux.

Run the following command to set BlueZ' support for multiple advertisements.

Your Linux system is now ready to install and run Ditto. For instructions on how to install and set up Ditto, see 

Getting Started in Your Project

Bluetooth on Linux

linux_aarm_supported_version

android_supported_version

ipados_supported_version

ios_supported_version

windows_x64_supported_version

mac_supported_version

linux_x64_supported_version

Best Practices

Sync Handling

Conflict Handling

Data Flow Management

1. Planning and Architecture Design

Optimizing Bundle Sizes for Android

2. Setup and SDK Configuration

Batch Write Transactions

Selecting the right pattern

Timestamps

Time-Based Replication

Schema Versioning

Large Binary Files

3. Data Modeling and Sync Logic

Maintaining Privacy in Peer-to-Peer Communication

Secure Peer-to-Peer Communication

Implementing Role-Based Access Control (RBAC)

4. Security, Access Control, and Privacy

Testing Best Practices: Big Peers, Small Peers, and Identity Switching

Setting Routing Hints

5. Testing and Optimization

Prioritizing Bluetooth Connections in High-Density Mesh Networks

Network Deployment

6. Deployment

Sync Performance with redundant BLE Connections

Wi-Fi Interference and Client Load

Device Storage Management

7. Performance Optimization and Troubleshooting

Integrate Ditto Tools for Kotlin, Swift and C# .NET in 15 Minutes

Device Observability and Ditto Logs

8. Monitoring and Maintenance

Inventory

Meal Ordering

Crew App

Chat

Chat App

Point-of-Sale (PoS)

Point of Sale

visionOS on Swift

@StateObject vs. @ObservedObject

DittoSwiftTools

Preventing SwiftUI Previews from Syncing

Preventing Accumulating Combine Publishers

Swift (cloned) (cloned)

Prebuilt Task App

Svelte Framework

OnlineWithAuthentication Tutorial: JavaScript

Getting started with Electron, TypeScript, Vite, and Ditto

JavaScript (cloned)

Offline peer-to-peer sync using JavaScript, React, and Auth0

Running a React Web App in an Android App

React Native

MAUI Task App

Console Task App

Permissions

Authentication Server

C# (cloned)

Mocking time in Async Rust

Rust (cloned)

How-To Tutorials