Skip to main content

Linux & Raspberry Pi

Ditto supports recent versions of Raspberry Pi and some other Linux-based systems

These instructions are required to run Ditto on Linux regardless of the programming language. This applies to all SDKs, including JavaScript (Node/Electron), C#, C++, etc.


Linux x86 64-bitFull support
Raspberry Pi 4B 32-bitFull supportBullseye
Raspberry Pi 3 32-bitFull supportBullseye
Linux ARM 64-bitComing soon
Linux SDK LanguageSupport
Node.jsFull support
RustFull support
C++Coming soon
PythonComing soon
Network TransportLinux Support
Bluetooth Low EnergyFull support
LAN / WLANFull support
Websockets (Big Peer)Full support
Apple AWDLNo (iOS/Mac only)
Wifi AwareNo (Android only)
Wifi DirectNo

System preparation for happy Ditto operation

Bluetooth Low Energy - BlueZ

If you would like to run Ditto on a Linux device and leverage Bluetooth Low Energy please follow the instructions.

Your device will need to install or update BlueZ with version 5.66 or higher. We've outlined a quick snippet set of instructions below to install BlueZ 5.66 as an example:

sudo apt-get updatesudo apt-get upgradesudo apt-get install libdbus-1-dev libglib2.0-dev libudev-dev libical-dev libreadline-dev docutils-common -ywget -xf bluez-5.66.tar.xzcd bluez-5.66./configuremakesudo make install

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, by default, iOS devices will 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 will need to disable the battery service in BlueZ, using the following steps.

  1. With your favorite editor, open the bluetooth service file. On Raspberry Pi OS it's located: /usr/lib/systemd/system/bluetooth.service, on other versions it may be here: /etc/systemd/system/
    You will probably need to use su permission to write to this file.

  2. Find the line beginning with ExecStart= and add -P battery to the end. Now the line should look like this:

ExecStart=/usr/lib/bluetooth/bluetoothd -P battery
  1. Save the file.
  2. Run sudo systemctl daemon-reload and sudo systemctl restart bluetooth to apply the changes to the Bluetooth service
  3. 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. You can prevent this with a little Bluetooth configuration on your Linux machines before running your app.
sudo hciconfig hci0 downsudo btmgmt bredr offsudo hciconfig hci0 up

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.

sudo setcap 'cap_net_raw,cap_net_admin+eip' `which hcitool` 

Your Linux system is now ready to install and run Ditto.

See here for Node.js SDK.
See here for Rust SDK.
The Python and C++ SDKs are in development. If you would like early access, please contact us

Linux demo application (Node.js)

Demo Ditto syncing from your Raspberry Pi to your iOS or Android device, over Bluetooth LE or WLAN using our Tasks App:

1) Make sure you've gone though the steps to prepare your system (see above). 2) Install Node Version Manager on your Pi.

wget -qO- | bash

Now restart your terminal session so the changes can be picked up.

3) Install the LTS version of Node.js (v18.13) on your Pi.

nvm install 18.13

4) Clone the samples app repo to your machine.

git clone samples/tasks/nodejs/

Edit the index.ts file to include your own test App ID and Token from

5) Run the demo app!.

npm installnpm run buildnode index.js

You should see this in your Pi's console:

************* Commands *************--insert my new task   Inserts a task   Example: "--insert Get Milk"--toggle myTaskTd   Toggles the isComplete property to the opposite value   Example: "--toggle 1234abc"--delete myTaskTd   Deletes a task   Example: "--delete 1234abc"--list   List the current tasks--exit   Exits the program************* Commands *************Your command:

6) Create a new task and then check to see it being updated in our handy data browser.
You'll need to log in and view the test app ID you created earlier.

7) Now build and run the Tasks app for iOS or Android.
Be sure to reuse the same App ID and Token as you used on your Pi.
iOS / Android examples are here.

Next steps

Learn more about how Ditto works