Quick Setup

Get Devspanso Running

Follow these steps to connect your local Espanso installation to your cloud dashboard and start syncing snippets across all your devices.

Install Espanso

If you don't have Espanso installed yet, download and install it from the official website.

Linux (Flatpak)

flatpak install flathub dev.devare.devspanso

macOS (Homebrew)

brew install espanso

View all install options →

Sign In to Your Account

Go to your dashboard, sign in with Google, and copy your User ID from the account settings page.

💡 Your User ID is a unique identifier that the Espanso client uses to securely fetch your snippets from the server. It never exposes your Google account credentials.

Go to Dashboard →

Configure Espanso for Cloud Sync

Add a cloud.yml file to your Espanso config directory:

~/.config/espanso/match/cloud.yml

# Devspanso Sync Configuration
# This file is managed automatically by espanso-cloud-sync.
# Do not edit manually.
espanso_cloud:
  user_id: "YOUR_USER_ID_HERE"
  api_base: "https://espanso-cloud.your-domain.workers.dev"

Replace YOUR_USER_ID_HERE with the User ID from your dashboard.

Run the Sync Agent

The Devspanso sync agent runs in the background, listens for server push events, and updates your local YAML files automatically.

Terminal

espanso-cloud sync --daemon

🔄 The agent will check your snippet hash on startup. If it differs from the server, it will download and apply the latest snippets. Any conflicts are resolved automatically (server wins for edits made within 5 minutes of each other).

Start Typing!

That's it! Go to your dashboard, create a new snippet, and it will instantly appear in Espanso on all your connected devices.

:date → 2026-08-04

:sig → Best regards, Your Name

:addr → 123 Main Street, City, Country

Ready to get started?

Go to Dashboard →