Connecting MinIO S3 Storage
Instructions for deploying and connecting local MinIO S3 to MikoPBX
This guide describes the process of deploying local MinIO S3 storage and connecting it to MikoPBX. All actions are performed on macOS - for other operating systems, the official documentation is available at the link.
Installing MinIO on macOS
Open the terminal and run the command:
brew install minio/stable/minioAfter the installation is complete, the terminal will display a confirmation:
🍺 /opt/homebrew/Cellar/minio/RELEASE.2025-09-06T17-38-46Z_1: 4 files, 108.2MB, built in 3 secondsCreate a directory for data.
mkdir -p ~/minio-dataStart the server:
MINIO_ROOT_USER=minioadmin MINIO_ROOT_PASSWORD=minioadmin \
minio server ~/minio-data --console-address ":9001"You will see the following output with useful information, including the WebUI address for convenient further work with the storage.
MinIO Object Storage Server
Copyright: 2015-2026 MinIO, Inc.
License: GNU AGPLv3 - https://www.gnu.org/licenses/agpl-3.0.html
Version: RELEASE.2025-09-06T17-38-46Z (go1.24.6 darwin/arm64)
API: http://192.168.100.114:9000 http://192.168.64.1:9000 http://127.0.0.1:9000
RootUser: minioadmin
RootPass: minioadmin
WebUI: http://192.168.100.114:9001 http://192.168.64.1:9001 http://127.0.0.1:9001
RootUser: minioadmin
RootPass: minioadmin
CLI: https://docs.min.io/community/minio-object-store/reference/minio-mc.html#quickstart
$ mc alias set 'myminio' 'http://192.168.100.114:9000' 'minioadmin' 'minioadmin'
Docs: https://docs.min.ioAfter starting, leave the terminal window open - closing it will stop the server.
To start MinIO automatically when the system starts, run:
Open a browser and go to the WebUI address.
Enter the credentials:
Username:
minioadminPassword:
minioadmin

Creating a Bucket in MinIO
Click "Create Bucket" in the left menu.

Enter a bucket name, for example
mikopbx-recordings.
Click "Create Bucket".

To create an access key and configure access permissions, you will need the mc console utility.
Install MinIO Client:
After installation, check the version:
Connecting MinIO Client to the Local Server
Add the local MinIO server as an alias:
Check the connection:
If the connection is successful, information about the MinIO server will appear in the terminal.

Creating a User and Bucket Access Policy
It is not recommended to use the MinIO root user for connecting external applications.
Create a separate user for MikoPBX:
Create a policy file:
Add the following content to it:
Save the file:
Create the policy in MinIO:
Attach the policy to the user:
Creating an Access Key for MikoPBX
Create an access key for the mikopbx-user user:
MinIO will display access data in response:
Save Access Key and Secret Key. They will be needed to connect MinIO to MikoPBX.
Secret Key is displayed only when it is created.
Connecting to MikoPBX
Go to the "Maintenance" -> "Storage" tab.

Open the "Cloud storage S3" tab and fill in the following fields:
Automatic recording upload to cloud storage - enable the switch.
S3 storage provider - MinIO
S3 endpoint URL -
http://192.168.64.1:9000S3 region - leave
us-east-1or enter any value (if you did not specify another one in the MinIO settings)S3 bucket name - specify the bucket name created in MinIO (
mikopbx-recordingsin this guide)Access key and Secret key - paste the values obtained in the previous part of this guide (key pair).
Configure the "Local storage period (S3 mode)" slider - choose how long recordings will be stored locally before being deleted after uploading to the cloud.
Click "Save".

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

Last updated
Was this helpful?

