Getting Started with CDUS
CDUS connects your personal computers and mobile devices into a single secure local network. It requires no centralized user account, no cloud storage subscription, and no open inbound router ports.
System Prerequisites
- Desktop Systems: Linux (Ubuntu 22.04+, Debian 12+, Arch, Fedora), Windows 10/11 (64-bit), or macOS 12+ (Apple Silicon & Intel).
- Mobile Devices: Android 10+ (API level 29 or higher).
- Network Environment: Local Area Network (Wi-Fi or Ethernet) for direct P2P connections. When firewalls block direct communication, CDUS automatically uses an encrypted fallback relay.
1. Installation
Linux
Download the native .deb package or universal .AppImage:
# Debian / Ubuntu
sudo dpkg -i cdus-desktop_0.1.0_amd64.deb
# AppImage
chmod +x cdus-desktop_0.1.0_amd64.AppImage
./cdus-desktop_0.1.0_amd64.AppImage
Windows
Run the signed NSIS installer cdus-desktop_0.1.0_x64-setup.exe or deploy via .msi in enterprise environments.
macOS
Open cdus-desktop_0.1.0_universal.dmg and drag the application icon to your /Applications directory.
Android
Install the native APK from GitHub Releases or deploy through your mobile device management tool.
2. Pairing Your First Two Devices
- Launch CDUS on your primary computer.
- Navigate to the Pairing tab and click Generate Pairing Code. A secure single-use QR code will appear on screen.
- Open CDUS on your Android phone or second computer, tap Scan QR, and point the camera at your desktop screen.
- Both devices execute an authenticated Noise XX cryptographic handshake. Once verified, the devices establish an encrypted session and exchange device certificates.
3. Verifying Synchronization
- Clipboard: Copy text or an image on your laptop. The content appears immediately in the clipboard history of your phone.
- File Transfer: Drag any file into the CDUS window or drop zone. Files transfer directly over LAN sockets with BLAKE3 chunk hashing for verified integrity.