Skip to main content
All Airstore configuration can be set via environment variables.

​
Client configuration

VariableDescriptionDefault
AIRSTORE_TOKENAuthentication token for mounting-
AIRSTORE_API_URLAPI endpoint URLhttps://api.airstore.dev
AIRSTORE_MOUNT_PATHDefault mount path~/airstore
AIRSTORE_CONFIG_PATHConfig file location~/.airstore/config.yaml
AIRSTORE_LOG_LEVELLog verbosity (debug, info, warn, error)info

​
Usage

# Set token for cloud mounting
export AIRSTORE_TOKEN=ast_xxxxxxxxxxxxxxxxxxxx

# Point to self-hosted instance
export AIRSTORE_API_URL=https://airstore.internal.company.com

# Mount
airstore mount /airstore

​
Server configuration (self-hosted)

VariableDescriptionDefault
DATABASE_URLDatabase connection string-
S3_ENDPOINTS3-compatible storage endpoint-
S3_BUCKETStorage bucket nameairstore
S3_ACCESS_KEYS3 access key-
S3_SECRET_KEYS3 secret key-
ENCRYPTION_KEYKey for encrypting tokens-
PORTServer port8080
HOSTServer bind address0.0.0.0

​
OAuth configuration

VariableDescription
GMAIL_CLIENT_IDGmail OAuth client ID
GMAIL_CLIENT_SECRETGmail OAuth client secret
GITHUB_CLIENT_IDGitHub OAuth client ID
GITHUB_CLIENT_SECRETGitHub OAuth client secret
LINEAR_CLIENT_IDLinear OAuth client ID
LINEAR_CLIENT_SECRETLinear OAuth client secret
SLACK_CLIENT_IDSlack OAuth client ID
SLACK_CLIENT_SECRETSlack OAuth client secret
NOTION_CLIENT_IDNotion OAuth client ID
NOTION_CLIENT_SECRETNotion OAuth client secret
GDRIVE_CLIENT_IDGoogle Drive OAuth client ID
GDRIVE_CLIENT_SECRETGoogle Drive OAuth client secret

​
Example: Docker

FROM ubuntu:22.04

ENV AIRSTORE_API_URL=https://api.airstore.dev
ENV AIRSTORE_LOG_LEVEL=info

RUN curl -sSL https://airstore.dev/install.sh | sh

CMD ["airstore", "mount", "/airstore"]

​
Example: Shell profile

Add to ~/.bashrc or ~/.zshrc: 
# Airstore configuration
export AIRSTORE_MOUNT_PATH="$HOME/airstore"
export AIRSTORE_LOG_LEVEL="info"

# Auto-mount on shell start (optional)
if ! mountpoint -q "$AIRSTORE_MOUNT_PATH" 2>/dev/null; then
  airstore mount "$AIRSTORE_MOUNT_PATH" &
fi

​
Example: CI/CD

# GitHub Actions
jobs:
  agent:
    runs-on: ubuntu-latest
    env:
      AIRSTORE_TOKEN: ${{ secrets.AIRSTORE_TOKEN }}
    steps:
      - name: Install Airstore
        run: curl -sSL https://airstore.dev/install.sh | sh
      
      - name: Mount
        run: |
          sudo apt-get install -y fuse3
          airstore mount /airstore
      
      - name: Run agent
        run: cd /airstore && claude "Review the PRs"

​
Precedence

Configuration is loaded in this order (later overrides earlier):
  1. Default values
  2. Config file (~/.airstore/config.yaml)
  3. Environment variables
  4. Command-line flags
# Config file sets mount path to ~/airstore
# Environment overrides to /mnt/airstore
export AIRSTORE_MOUNT_PATH=/mnt/airstore

# Flag overrides to /custom/path
airstore mount /custom/path

​
Next steps

Local deployment

Set up local mounting.

Cloud deployment

Deploy in cloud sandboxes.