Skip to main content

Storage Configuration

Aicser stores uploaded files (CSV, Excel, PDFs for the knowledge base). By default, files are stored on the local container filesystem — not recommended for production as files are lost if the container is replaced.

Options

BackendSTORAGE_BACKEND valueUse when
Local filesystem(unset)Development only
S3-compatibles3AWS S3, MinIO, Cloudflare R2, DigitalOcean Spaces
Azure BlobazureAzure-hosted deployments

S3-compatible storage

STORAGE_BACKEND=s3
S3_PROVIDER=aws # aws | minio | cloudflare
S3_ACCESS_KEY_ID=your-access-key
S3_SECRET_ACCESS_KEY=your-secret-key
S3_BUCKET_NAME=your-bucket-name
S3_REGION=us-east-1

# For non-AWS providers, set the endpoint URL
S3_ENDPOINT_URL=https://your-minio-instance.example.com

Create the bucket before starting Aicser. The bucket should be private (no public access).

Azure Blob Storage

STORAGE_BACKEND=azure
AZURE_STORAGE_ACCOUNT=your-storage-account-name
AZURE_STORAGE_CONTAINER=your-container-name
AZURE_CLIENT_ID=your-azure-client-id
AZURE_CLIENT_SECRET=your-azure-client-secret
AZURE_TENANT_ID=your-azure-tenant-id

The container should be private. The service principal needs the Storage Blob Data Contributor role on the container.