atuinsh/atuin · error

There was an error with the atuin sync service at {url}, ser

Error message

There was an error with the atuin sync service at {url}, server error {status}: {reason}.
If the problem persists, contact the host

What it means

Mapping in handle_resp_error for HTTP 5xx server errors whose JSON body parses as an ErrorResponse: the sync backend at {url} failed while processing a request from register, login, latest_version, page, me, or delete_store. The request was well-formed but the server returned its own structured error reason; the fault lies with the server.

Source

Thrown at crates/atuin-client/src/api_client.rs:255

            "Service unavailable: check https://status.atuin.sh (or get in touch with your host)"
        );
    }

    if status == StatusCode::TOO_MANY_REQUESTS {
        bail!("Rate limited; please wait before doing that again");
    }

    if !status.is_success() {
        let body = resp.text().await.unwrap_or_default();

        if let Ok(error) = serde_json::from_str::<ErrorResponse>(&body) {
            let reason = error.reason;

            if status.is_client_error() {
                bail!("Invalid request to the service at {url}, {status} - {reason}.");
            }

            bail!(
                "There was an error with the atuin sync service at {url}, server error {status}: \
                 {reason}.\nIf the problem persists, contact the host"
            );
        }

        bail!(
            "There was an error with the atuin sync service at {url}, Status \
             {status:?}.\nResponse body: {body}\nIf the problem persists, contact the host"
        );
    }

    Ok(resp)
}

/// Build the capability reader for a sync server.
#[instrument(level = "trace", skip_all, err)]
pub fn caps_client(settings: &Settings) -> Result<Arc<CapClient>> {
    let auth_settings = Arc::new(settings.clone());

View on GitHub (pinned to c0c717ab04)

Solutions

1. Retry after a short delay; server errors are often transient
2. Check https://status.atuin.sh for a known incident
3. If self-hosting, examine the server logs around the reported {reason}

When it happens

Trigger: Thrown at crates/atuin-client/src/api_client.rs:255 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of atuinsh/atuin@c0c717ab04 (2026-09-12). Data as JSON: /api/errors/98145bc77e47ca65. Report an issue: GitHub.