Connecting DigitalOcean S3 Storage

Instructions for connecting DigitalOcean Spaces Object Storage as an S3 storage

Creating a Bucket and Access Keys

1. Go to the DigitalOcean console (link).

2. Navigate to Manage → Spaces Object Storage. Click Create a Spaces Bucket to create a new bucket.

Spaces Object Storage section

1. On the bucket creation page, under Choose a datacenter region, select the region closest to your MikoPBX server. Choose Standard Storage.

Remember your region name (sgp1 in the screenshot below) — you will need it later when configuring MikoPBX.

Bucket creation parameters #1

1. In the Choose a unique Spaces Bucket name field, enter a name of your choice for the bucket.

Click Subscribe & Create Bucket.

Bucket creation parameters #2

1. Open the page of the newly created bucket by clicking its name in the Buckets section.

Created bucket in the Buckets section

1. Go to the Settings tab.

Settings tab on the created bucket page

1. Scroll down to the Access Keys section. Click Create Access Key to generate a new key pair.

Access Keys section

1. Fill in the required parameters for the new key:

• Select access scope — Limited Access.

• Buckets — select the bucket you created earlier.

• Permissions — Read/Write/Delete.

• Give this access key a name — enter an arbitrary name to identify this key pair.

Click Create Access Key.

Access key creation parameters

Your key pair values (Access Key ID and Secret Key) will be displayed. Save these values — you will need them when configuring MikoPBX.

Access key pair

Connecting to MikoPBX

1. Go to the Maintenance → Storage tab.

Storage section in MikoPBX web-interface

1. Open the S3 Cloud Storage tab and fill in the following fields:

• Automatically upload recordings to cloud storage — enable the toggle.

• S3 Endpoint URL — enter https://sgp1.digitaloceanspaces.com, replacing sgp1 with your region.

• S3 Region — enter the region of your DigitalOcean bucket (e.g. sgp1 in this guide).

• S3 Bucket Name — enter the name of the bucket you created in DigitalOcean (e.g. mikopbx-s3-storage in this guide).

• Access Key and Secret Key — paste the values obtained in the first part of this guide.

Use the Local Storage (S3 mode) slider to configure how long recordings are kept locally before being deleted after upload to the cloud.

A shorter local retention period frees up disk space faster.

Click Save.

DigitalOcean S3 connection parameters

After saving the settings, click Test Connection. If the connection is successful, you will see the message "S3 connection successful" and synchronization of call recordings will begin.

Successful connection