Skip to content Skip to content

HOW-TO GUIDE

Updating d3kOS

There are two ways to update: OTA (over-the-air, T1 and above) and manual image replacement (T0 or recovery).

T1 · T2 · T3

Method 1 — OTA Update

Over-the-air updates download and install directly on your Pi. No microSD required.

  1. 1
    Open the d3kOS dashboard on your Pi

    Connect to your Pi's IP address in a browser on the same network.

  2. 2
    Tap Settings → System → Check for Updates

    The system checks AtMyBoat.com for the latest version.

  3. 3
    If an update is available, tap Install Update

    The download runs in the background — approximately 5 minutes depending on your connection.

  4. 4
    Tap Restart to apply

    The Pi reboots once. The dashboard will be unavailable for about 2 minutes during restart.

  5. 5
    After restart, verify the version in Settings → About

    Confirm the version number matches the latest release.

T2 and T3 automatic updates: OTA updates install automatically on T2 and T3. You will see a notification banner on the dashboard when an update is ready.
T0 · Recovery

Method 2 — Manual Image Replacement

Use this method if you are on T0 (no OTA) or if your Pi will not boot after an update.

  1. 1
    Download the latest d3kOS image

    Go to /download and download the current release (.zip file).

  2. 2
    Flash to a fresh microSD card

    Use Raspberry Pi Imager (recommended) or Balena Etcher. Select the .img file inside the zip.

  3. 3
    Swap the microSD in your d3-k1

    Power off the Pi, remove the old card, insert the new one.

  4. 4
    Power on and run the 20-step setup wizard

    The wizard runs automatically on first boot.

  5. 5
    Re-enter your configuration

    T0 has no cloud backup — note down your settings before flashing.

T1, T2, and T3: Your voyage history and settings are preserved in the cloud. After flashing, pair your device at /pair-device and everything restores automatically.