droboticflow-new/docs/drosync/installation.md
2026-07-28 20:43:46 +08:00

2.0 KiB

Installation

Common prerequisites

  • The control-plane base URL must be reachable over public HTTPS.
  • An administrator enters the browser short code in /object-sync → Devices, verifies the resolved device, and assigns one or more space/prefix/action scopes. Pending requests are not broadcast across organizations.
  • Headless service credentials must come from DROSYNC_TOKEN or a 0600 file named by DROSYNC_SECRET_FILE.
  • Do not put device credentials, BOS AK/SK, signing keys, or notarization profiles in the repository.

Ubuntu 22.04/24.04 x86_64

Install the signed DEB and enable either one mode:

sudo dpkg -i drosync_1.0.0_amd64.deb
systemctl --user enable --now drosync.service
# Or, for a managed machine:
sudo systemctl enable --now drosync.service

The portable tarball contains all three binaries and a user systemd unit. Validate the detached GPG signature and SHA-256 before extraction.

macOS 13+ arm64

Install the notarized .pkg. It installs /Applications/drosync.app, /usr/local/bin/drosync, a LaunchAgent, and a LaunchDaemon definition. Enable only the per-user agent or the administrator-managed daemon:

launchctl bootstrap gui/"$(id -u)" /Library/LaunchAgents/com.drobotics.drosync.agent.plist
sudo launchctl bootstrap system /Library/LaunchDaemons/com.drobotics.drosync.daemon.plist

The package must pass spctl --assess --type install and have a stapled notarization ticket.

Windows 10/11 x86_64

The Authenticode-signed MSI installs the CLI, GUI, and Windows Service. Run it elevated for system service mode. install-user.ps1 provides a non-admin per-user login-start alternative. Validate with:

Get-AuthenticodeSignature .\drosync-1.0.0-windows-x86_64.msi
Get-Service drosync

First configuration

drosync configure --server https://data.example.com
drosync auth --server https://data.example.com --profile default
drosync mapping add /data/capture --space oss_example --remote-prefix incoming
drosync doctor
drosync plan <mapping-id>
drosync sync <mapping-id>