Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stashy.sh/llms.txt

Use this file to discover all available pages before exploring further.

Set STORAGE_BACKEND to choose where files are stored.

​
Memory

STORAGE_BACKEND=memory  # default
In-memory and ephemeral — files are lost on restart. Good for development and testing.

​
Local Disk

STORAGE_BACKEND=local
LOCAL_STORAGE_DIR=./storage
Files are written to disk. Make sure the directory exists and is writable. Use a persistent volume in Docker.

​
Google Cloud Storage

STORAGE_BACKEND=gcs
GCS_BUCKET=my-stashy-bucket
Uses Application Default Credentials. In GCE/Cloud Run, this works automatically. Locally, run: 
gcloud auth application-default login

​
Amazon S3

STORAGE_BACKEND=s3
S3_BUCKET=my-stashy-bucket
Uses the standard AWS SDK credential chain (environment variables, ~/.aws/credentials, IAM role, etc.). Works with any S3-compatible storage like MinIO, Cloudflare R2, or DigitalOcean Spaces — set AWS_ENDPOINT_URL to point to your provider.
For production, use local, gcs, or s3. The memory backend is only for development.