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.

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}