Configuration Reference

RelayPlane stores config in ~/.relayplane/config.json. The fields below reflect packages/proxy/src/config.ts exactly.

Top-level fields

FieldTypeDefaultNotes
device_idstringauto-generatedAnonymous ID (anon_xxx) generated once.
telemetry_enabledbooleanfalseTelemetry toggle.
first_run_completebooleanfalseSet true after first-run disclosure.
api_keystring?unsetOptional RelayPlane API key.
config_versionnumber1Schema version.
created_atstringcurrent ISO timestampCreation timestamp.
updated_atstringcurrent ISO timestampUpdated on every save.
meshobject?see belowMesh learning settings.

mesh section

FieldTypeDefaultNotes
mesh.enabledbooleanfalseMay be auto-enabled for authenticated users.
mesh.endpointstringhttps://osmosis-mesh-dev.fly.devMesh sync endpoint.
mesh.sync_interval_msnumber60000Sync interval in ms.
mesh.contributebooleantrueAllow anonymized contribution.

Credential Pool and Quarantine

When you configure multiple credentials in your proxy pool, the proxy automatically quarantines any credential that returns two consecutive auth failures (HTTP 401). The quarantine lasts one hour, after which the credential re-enters the rotation. This prevents a single bad credential from blocking all requests while the pool continues serving traffic via the remaining credentials.

Example config.json

1{
2  "device_id": "anon_a1b2c3d4e5f6g7h8",
3  "telemetry_enabled": false,
4  "first_run_complete": true,
5  "config_version": 1,
6  "created_at": "2026-02-25T18:00:00.000Z",
7  "updated_at": "2026-02-25T18:10:00.000Z",
8  "mesh": {
9    "enabled": false,
10    "endpoint": "https://osmosis-mesh-dev.fly.dev",
11    "sync_interval_ms": 60000,
12    "contribute": true
13  }
14}