Platform/OS
Cross-platform
Category
Databases

Couchbase

Couchbase is a flexible database that stores and manages information for apps and websites. It acts like a super-organized digital filing cabinet that lets developers quickly save, find, and update data as people use their apps. It uses S3-compatible object storage to keep copies of your important data safe in the cloud without needing expensive special servers. This setup makes it easy to grow your storage as your business gets bigger while keeping costs low. The combination gives you fast app performance plus rock-solid backups that protect against data loss.

Connection / Setup

  1. Create an account and log in to DiskSpace
  2. Click I'm ready to set up my storage
  3. Enter Bucket Name following the instructions
  4. Click Create Bucket and wait for it to be generated
  5. Find your Endpoint URL, Access Key, and Secret Key in the S3 Client Configuration section for use below

Connect Couchbase to DiskSpace.sh (S3-compatible Storage)

DiskSpace.sh provides fully S3 API compatible storage. Follow the steps below to configure Couchbase to use DiskSpace.sh as an object store.

Connection Steps:
  1. Log in to your Couchbase Server Web Console.
  2. Navigate to Settings > Backup or the specific S3 integration section for your Couchbase service.
  3. Select Add Repository or Configure S3 Destination.
  4. Fill in the connection details as shown below.
  5. Save and test the connection.
Required Credentials
Use this exact endpoint URL.
Can be left empty or set to us-east-1.
Important: Path-Style Requests Required

DiskSpace.sh requires path-style URLs. Couchbase must be configured to use path-style addressing instead of virtual-hosted style.

Example:
https://s3.diskspace.sh/bucket-name/key

Example Configuration
Endpoint: https://s3.diskspace.sh
Access Key ID: AKIAXXXXXXXXXXXXXXXX
Secret Access Key: ********************************
Region: us-east-1
Path Style: Enabled (required)
Bucket: your-bucket-name
Troubleshooting Tips
  • Ensure Path Style is explicitly enabled in Couchbase settings.
  • Verify your Access Key and Secret Key have the necessary S3 permissions (s3:GetObject, s3:PutObject, s3:ListBucket, etc.).
  • If connection fails, try setting Region to us-east-1 even if not required.
  • Check that your firewall or network allows outbound HTTPS traffic to s3.diskspace.sh.
  • Review Couchbase logs for detailed S3 error messages.