Skip to content
Clawbolt

Storage Providers

Clawbolt can catalog job photos, estimates, and documents to a storage backend. Three providers are supported.

Local (default)

Section titled “Local (default)”

Works out of the box with no configuration. Files are saved to data/storage/ on disk.

data/storage/
├── Job Photos/
│   └── 2026-02-28/
│       ├── site-front.jpg
│       └── site-back.jpg
└── Estimates/
    └── EST-001.pdf

This is ideal for development and demos. Set STORAGE_PROVIDER=local or leave it unset (it’s the default).

Dropbox

Section titled “Dropbox”
  1. Go to the Dropbox App Console and create a new app
  2. Choose Scoped access and Full Dropbox (or App folder for sandboxed access)
  3. Under Permissions, enable: files.content.write, files.content.read, sharing.write, sharing.read
  4. Generate an access token on the app’s settings page
  5. Set environment variables:
Terminal window
STORAGE_PROVIDER=dropbox
DROPBOX_ACCESS_TOKEN=sl.xxxxx...

Google Drive

Section titled “Google Drive”
  1. Go to the Google Cloud Console and create a project
  2. Enable the Google Drive API
  3. Create OAuth 2.0 credentials (Desktop app type)
  4. Complete the OAuth flow to get a credentials JSON
  5. Set environment variables:
Terminal window
STORAGE_PROVIDER=google_drive
GOOGLE_DRIVE_CREDENTIALS_JSON='{"token": "...", "refresh_token": "...", ...}'