Troubleshoot Arc en Ciel Link

Fix disconnected Link, rejected Link Keys, missing local bases, stale sidecars, and mismatched files.

Last updated: 30 June 2026 · Template: troubleshooting · Audience: signed-in, developer · Difficulty: advanced · Reading time: 10 min

Before you start

A configured local Link integration.
Access to local extension logs and Arc en Ciel settings.

Quick answer

Start with the simple checks: are you signed in, is the Link Key still active, and is the local tool using the right backend URL?
If local models are missing, check folder paths and sidecars before creating a new Link Key.
After changing keys, paths, or extension settings, restart the local tool and rescan.

Debug in this order

Most Link issues come from a small set of places: login, network, Link Key, local path, or stale sidecar. Check them in that order so you do not rotate keys when the real problem is a renamed folder.

Arc en Ciel Link panel showing an anonymized disconnected troubleshooting state. — **Link troubleshooting state** - The Link panel is the first place to check connection state, recent errors, and whether local actions are available.

Arc en Ciel Link connection panel. — **Compare the error state with the normal Link panel** - The normal Link panel is still the best place to confirm Link Key scope, queue options, and whether local Link actions should be available.

Diagnostic steps

Confirm you can sign in to Arc en Ciel in the browser.
Open settings and verify the Link Key still exists and has the required scope.
Check local extension logs for HTTP status codes or connection errors.
Confirm local model directories and sidecar paths exist on disk.
Rescan or regenerate sidecars after moving files.
Restart the local tool after changing Link Keys, paths, or extension configuration.

Common Link failures

Disconnected

Likely cause: Network issue, wrong backend URL, expired Link Key, or local tool not restarted.

Fix: Check URL and Link Key, restart the tool, then inspect logs for the first failing request.

403 or unauthorized

Likely cause: Link Key lacks the needed access or belongs to a different account.

Fix: Create a dedicated Link Key from the correct account.

Local base not found

Likely cause: Base model folder is missing, renamed, or not scanned.

Fix: Fix local path and trigger inventory refresh.

Sidecar mismatch

Likely cause: File moved or changed after metadata was written.

Fix: Regenerate sidecar metadata and verify hash.

Download appears twice

Likely cause: Duplicate local files or stale metadata references.

Fix: Deduplicate files and refresh local inventory.

Should I paste a Link Key into Discord for help?

No. Share screenshots with keys hidden, then rotate the Link Key if you think it may have been exposed.

Does Link upload my local models automatically?

No. Link is meant to connect metadata and local tooling. Publishing or uploading remains an explicit action.

Why does a model work locally but not appear in Link?

The local tool may know the file path while Link needs hash, sidecar, or inventory metadata to match it to Arc en Ciel.

Open Settings