Environment Variables and Filesystem Locations

Debugging Variables

ASTRONOMICAL_DEBUG_BOOT
ASTRONOMICAL_DEBUG_PLUGINS
ASTRONOMICAL_DEBUG_MAPPING
ASTRONOMICAL_DEBUG_PERSISTENCE

Set a value of 1 before starting AstronomicAL to enable the corresponding diagnostics.

Plugin Search Path

ASTRONOMICAL_PLUGIN_PATH adds one or more local plugin locations.

Workspace Files

Workspace JSON contains layouts, plugin IDs, dataset registrations, mappings and panel state.

Cache and Artifact Files

Parquet caches, model sidecars and remote products may be written outside the workspace file.

Cleaning Local State

Do not delete a cache directory until checking whether it contains the only copy of a model, imported dataset or remote artifact.