LogoOctoclip Docs

    BYOC Configuration

    BYOC (Bring Your Own Cloud) lets you store sync data in your own cloud infrastructure for stronger control over data residency and compliance.

    Supported options

    OptionTypical implementationBest for
    WebDAVSelf-hosted WebDAV or third-party WebDAV serviceFast onboarding with lower ops complexity
    S3-compatible storageS3, MinIO, or object storage servicesScalable setups with fine-grained IAM

    Core fields

    FieldTypeRequiredDescription
    providerstringYesBackend type, such as webdav or s3
    endpointstringYesService endpoint URL
    bucketstringNoTarget bucket/container (S3 flows)
    usernamestringNoAccount or access key identifier
    passwordstringNoPassword or secret key
    pathPrefixstringNoNamespace prefix for sync objects

    Setup flow

    1

    Prepare credentials and permissions

    Confirm endpoint reachability and read/write policy readiness.

    2

    Fill BYOC fields in app settings

    Enter required parameters based on your provider.

    3

    Run connection test

    Verify test object read/write before enabling production sync.

    Example

    byoc.config.jsonjson
    {  "provider": "s3",  "endpoint": "https://s3.example.com",  "bucket": "octoclip-sync",  "pathPrefix": "prod/user-a/",  "username": "ACCESS_KEY",  "password": "SECRET_KEY"}
    WARNING

    Never commit credential-bearing config files to public repositories. Prefer environment variables or secret managers.

    Common issues

    Was this page helpful?