Skip to content

Improving connection reliability #

The Dataplicity agent reconnects after network changes, but the operating system and application still need reliable network, time, and power behaviour.

Keep time accurate #

Incorrect system time can cause TLS certificate failures. Enable the distribution's supported time synchronisation service and verify it recovers after power loss and long offline periods.

For a systemd-based distribution:

shell
timedatectl status
systemctl status systemd-timesyncd

Use the time service recommended by your Linux distribution if it does not use systemd-timesyncd.

Make networking recoverable #

  • Use the distribution's supported network manager
  • Configure DNS and default routes explicitly
  • Test DHCP lease renewal and access-point changes
  • Add bounded retries with backoff to your own application
  • Avoid custom scripts that restart undocumented Dataplicity processes or depend on internal agent paths

Design for field power conditions #

  • Use a reliable power supply sized for the hardware and attached peripherals
  • Protect writable storage from abrupt shutdowns
  • Test repeated power cycles
  • Use a hardware watchdog where unattended recovery is required

Observe recovery #

Test on a staging unit:

  1. Disconnect and restore its network
  2. Reboot the router while the device remains powered
  3. Power-cycle the device
  4. Correct a deliberately inaccurate system clock
  5. Confirm the device returns online and resumes expected logs and monitors

Contact Dataplicity support before adding service-manager overrides for the agent. Supported process names and installation details can vary by agent release and operating system.