Skip to main content

Configuration reference

This page is the practical reference layer above the raw environment-variable index.

Connectivity​

Primary endpoint settings:

  • AFS_AETHER_SERVER_ENDPOINT
  • [bridge].server_endpoint

Identity setting:

  • AFS_AETHER_WORKER_ID
  • [bridge].worker_id

Use these for:

  • choosing the remote environment
  • labeling a local worker or machine
  • making shell wrappers explicit

Local storage and cache​

Primary cache settings:

  • AFS_AETHER_CACHE_DIR
  • cache_dir
  • AFS_AETHER_CACHE_SHARED_ROOT
  • shared_cache_root

Use separate cache roots when:

  • switching between environments
  • running CI versus interactive work
  • isolating temporary automation from personal workstation state

Logging​

Primary logging settings:

  • AFS_AETHER_LOG
  • log_level
  • AFS_AETHER_LOG_FORMAT
  • [logging].format

Use:

  • text for local debugging
  • json for machine ingestion

Metrics​

Primary metrics settings:

  • AFS_AETHER_CLIENT_METRICS_ADDR
  • metrics_addr

Use this when:

  • you want local observability
  • you are diagnosing client behavior
  • you are scraping client metrics from a workstation or runner

Metadata freshness and TTL​

Primary TTL settings:

  • AFS_AETHER_LOOKUP_TTL_SECS
  • lookup_ttl_secs
  • AFS_AETHER_NEGATIVE_LOOKUP_TTL_SECS
  • negative_lookup_ttl_secs
  • AFS_AETHER_DIR_CACHE_TTL_SECS
  • dir_cache_ttl_secs

Lower values favor freshness.

Higher values favor fewer remote lookups.

Local interactive default​

  • explicit endpoint
  • personal cache root
  • text logs
  • metrics enabled only when debugging
  • moderate TTLs

CI or automation​

  • explicit endpoint
  • dedicated cache root
  • JSON logs
  • metrics only if collected
  • short-lived runtime

Multi-environment workstation​

  • one wrapper per environment
  • one cache root per environment
  • explicit worker ID

Deep reference​

For the exhaustive generated setting inventory, use Aether CLI environment variables.