← Back to Documentation

Site Sync

Troubleshooting Site Sync

General

“Last contact” shows an error

  • Check that your Live Site URL is correct
  • Make sure the live site is running
  • Verify both sites use the same sync token

Push/Pull buttons are disabled

  • Wait for sync status to refresh
  • Check that the connection is healthy
  • Verify you typed LIVE correctly when confirming

Kamal

Permission denied (publickey)

This is an SSH key error. The most common Site Sync failure. The host/server rejected the SSH key your machine offered. Two things both need to be true for Site Sync to work via SSH:

1. The right key is picked in Roe.

Go to Deploy settings → Common Settings → SSH key dropdown. Pick the key whose public counterpart is authorized on the server. Save.

2. The counterpart SSH key has been added to your host/server

The best instructions for setting up SSH on your host/server is in your host’s documentation. Search there first.

If you’re unfamiliar with SSH, read this article: How To Set up SSH Keys on a Linux / Unix System

This article explains How to Create SSH Keys with OpenSSH on macOS or Linux

This article explains How to Manage SSH Public Keys on DigitalOcean, which is very similar to other platforms.

Fly

Error: Not authenticated / Site Sync fails when Fly is your host/server

From your Roe install directory:

fly auth login

That opens a browser window to authenticate. Session persists locally afterward.

Fly CLI not installed

macOS (Homebrew):

brew install flyctl

macOS / Linux (official installer):

curl -L https://fly.io/install.sh | sh

Then sign in:

fly auth login

App not found

The app name in Deploy settings doesn’t match an app in your Fly account. Verify:

fly apps list

The app name in this list must match App name in Deploy settings exactly. Lowercase, no spaces, hyphens only.

General

Restart helps

A fresh restart re-reads all settings.

Still stuck?

Run Site Sync, copy the full error from the failed-transfer panel, and send an email: roe@weareontheweb.com