forked from longtao.wu/droboticflow
2.0 KiB
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_TOKENor a0600file named byDROSYNC_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>