Skip to content

unwired: AKROASIS_VAULT_PATH env var read at runtime but documented nowhere — override path is invisible to operators #253

Description

@forkwright

Finding

AKROASIS_VAULT_PATH is read in default_vault_path() in akroasis/crates/akroasis/src/vault/mod.rs to override the default vault storage path (~/.local/share/akroasis/vault). The variable is never mentioned in any workflow, deploy script, README, CLAUDE.md, or documentation file. Its existence is known only by reading the source.

Evidence

akroasis/crates/akroasis/src/vault/mod.rs:14: single env::var("AKROASIS_VAULT_PATH") read site. rg 'AKROASIS_VAULT_PATH' akroasis/ outside this file = 0 hits. No mention in .github/workflows/, scripts, README, or CLAUDE.md.

Why this matters

Operators who need to place the vault at a non-default path (multi-user install, NAS-backed storage, test isolation) have no documented mechanism to do so. The override exists and works but is discoverable only by source inspection. Any deploy playbook that omits this variable is making an implicit assumption about the vault location with no documented alternative.

Desired correction

Add an "Environment Variables" section to the akroasis README (or CLAUDE.md if no README exists) documenting AKROASIS_VAULT_PATH: its purpose, default value, and example usage. No code change required.

Done when: AKROASIS_VAULT_PATH appears in the repo documentation with its default value and override semantics described.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions