Skip to content
Clawbolt

Storage Providers

Clawbolt can catalog job photos 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

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

When running with Docker Compose, the data/ directory is bind-mounted to the host (default: ./data in the project root) so files persist across container rebuilds. Set CLAWBOLT_DATA_DIR to change the host path:

Terminal window
CLAWBOLT_DATA_DIR=/mnt/storage/clawbolt

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": "...", ...}'