ENVRC_LOCAL.md

Example: .envrc.local

Overview

This example shows a personal .envrc.local for direnv to load InfraFoundry config paths and credentials locally.

Audience and Prerequisites

• Audience: Developers using direnv for local InfraFoundry work.
• Prereqs: direnv installed and allowed in the repo; access to your config repo and credentials.

When to Use This

• Setting per-user overrides for config repo paths and log levels.
• Storing provider credentials locally (never committed).

Quick Start

1. Copy the example:

   cp docs/examples/.envrc.local.example .envrc.local

2. Edit values for your environment and allow direnv:

   direnv allow

Configuration Details

• Variables: Point INFRAFOUNDRY_CONFIG_REPO to your config repo; set log levels and provider creds.
• Location: .envrc.local at repo root; git-ignored.

Validation and Checks

• Run direnv status to confirm variables are loaded.
• Verify printenv | grep INFRAFOUNDRY shows expected values.

Examples

• Sample content:

  export INFRAFOUNDRY_CONFIG_REPO=$HOME/my-infra-config
  export INFRAFOUNDRY_LOG_LEVEL=INFO
  export KUBECONFIG=$HOME/.kube/config

Related Documentation

• direnv Setup
• Per-Environment Credentials
• Configuration Guide

Troubleshooting

• Symptom: Variables not applied. Fix: Ensure .envrc.local exists, run direnv allow, then direnv reload.
• Symptom: Credentials missing. Fix: Export provider credentials in .envrc.local; keep file git-ignored.

---

Last updated: 2025-12-23 14:27 GMT

---

Back to Table of Contents