Installation

Installation

Pre-built packages bundle both the desktop UI and the sync daemon — there is nothing extra to install or configure separately. Just install the package for your platform and you are ready to go.

Running on a server or NAS? Skip this page. See Docker for container-based deployment, or Quadlet for rootless systemd-managed containers. This page covers the desktop app only.

---

Quick Install (Linux)

An interactive script detects your distro and downloads the right package automatically:

curl -fsSL https://raw.githubusercontent.com/ciberkids/cloud-drive-sync/main/install.sh | bash

The script installs the package, enables the systemd user service, and warns you if ~/.local/bin is not on your PATH. For a manual install, follow the platform-specific steps below.

---

Linux

Debian / Ubuntu / Mint (.deb)

# Download the latest .deb from the releases page
# https://github.com/ciberkids/cloud-drive-sync/releases/latest
# Then install it:
sudo dpkg -i cloud-drive-sync_*.deb
sudo apt-get install -f          # pulls in any missing dependencies

# Enable the daemon to start automatically on login
systemctl --user enable --now cloud-drive-sync-daemon

# Launch the desktop UI
cloud-drive-sync-ui

Tip: You can also install directly from the command line using the gh CLI:

gh release download --repo ciberkids/cloud-drive-sync --pattern '*.deb' --dir /tmp
sudo dpkg -i /tmp/cloud-drive-sync_*.deb
sudo apt-get install -f

---

Fedora / RHEL / openSUSE (.rpm)

# Download the latest .rpm from the releases page
# https://github.com/ciberkids/cloud-drive-sync/releases/latest
# Then install it:
sudo rpm -U cloud-drive-sync-*.x86_64.rpm

# Enable the daemon to start automatically on login
systemctl --user enable --now cloud-drive-sync-daemon

# Launch the desktop UI
cloud-drive-sync-ui

Tip: Using the gh CLI:

gh release download --repo ciberkids/cloud-drive-sync --pattern '*.rpm' --dir /tmp
sudo rpm -U /tmp/cloud-drive-sync-*.x86_64.rpm

---

AppImage (any distro)

No installation or root access required — download and run directly:

# Download the latest AppImage
gh release download --repo ciberkids/cloud-drive-sync --pattern '*.AppImage' --dir ~/bin
chmod +x ~/bin/Cloud.Drive.Sync_*.AppImage

# Run it
~/bin/Cloud.Drive.Sync_*.AppImage

Or download manually from the releases page, make it executable, and double-click it in your file manager.

The AppImage includes the daemon and starts it automatically when no running daemon is detected. No systemctl setup is needed.

---

Flatpak (any distro)

# Download the Flatpak bundle
wget https://github.com/ciberkids/cloud-drive-sync/releases/latest/download/cloud-drive-sync.flatpak

# Install for the current user (no root needed)
flatpak install --user cloud-drive-sync.flatpak

# Launch
flatpak run com.cloud_drive_sync.app

The Flatpak bundles the daemon as a sidecar binary, so no separate install is needed. The daemon starts automatically when the app launches.

---

macOS

Download the .dmg disk image from the latest release:

1. Open the downloaded .dmg file.
2. Drag Cloud Drive Sync into your Applications folder.
3. Open it from Launchpad or Spotlight.

The app will ask for permission to manage files in your chosen sync folders on first launch.

Homebrew cask — coming soon:

brew install --cask cloud-drive-sync

---

Windows

Download the installer (.msi or .exe) from the latest release:

1. Run the downloaded installer and follow the prompts.
2. Cloud Drive Sync will appear in your Start menu and system tray after installation.
3. The daemon runs as a background process managed by the desktop app.

Scoop — coming soon:

scoop install cloud-drive-sync

---

After Installation

Once installed, open the app and:

1. Go to Accounts and sign in to your cloud provider (Google Drive, Dropbox, OneDrive, Nextcloud, or Box).
2. Go to Pairs and add a sync folder pair (local folder ↔ remote folder).
3. Sync starts automatically. Check the Status dashboard to monitor progress.

For CLI usage and advanced configuration, see CLI and Daemon.