DDEV MinIO

Overview

MinIO is an object storage system. It is API compatible with the Amazon S3 cloud storage service. It is capable of working with unstructured data such as photos, videos, log files, backups, and container images with the maximum supported object size being 50TB.

This add-on integrates MinIO into your DDEV project.

Installation

ddev add-on get ddev/ddev-minio
ddev restart

After installation, make sure to commit the .ddev directory to version control.

Usage

MinIO console credentials

File access

Project docker instances can access MinIO API via http://minio:10101

DDEV router is configured to proxy the requests to https://<project>.ddev.site:10101 to MinIO S3 API.

Example URLs for accessing files are

Connecting from PHP

Installation

Since MinIO is S3 compatible you can use AWS PHP SDK. Install it with composer:

ddev composer require aws/aws-sdk-php

Basic usage

<?php

require __DIR__ . '/vendor/autoload.php';

$s3 = new \Aws\S3\S3Client([
    'endpoint' => 'http://minio:10101',
    'credentials' => [
        'key' => 'ddevminio',
        'secret' => 'ddevminio',
    ],
    'region' => 'us-east-1',
    'version' => 'latest',
    'use_path_style_endpoint' => true,
]);

$bucketName = 'ddev-minio';

if (!$s3->doesBucketExist($bucketName)) {
    $s3->createBucket([
        'Bucket' => $bucketName,
    ]);
}

$s3->putObject([
    'Bucket' => $bucketName,
    'Key' => 'ddev-test',
    'Body' => 'DDEV Minio is working!',
]);

$object = $s3->getObject([
    'Bucket' => $bucketName,
    'Key' => 'ddev-test',
]);

echo $object['Body'];

Advanced Customization

To change the Docker image:

ddev dotenv set .ddev/.env.minio --minio-docker-image=minio/minio:latest
ddev add-on get ddev/ddev-minio
ddev restart

You can modify .ddev/docker-compose.minio.yaml directly by removing the #ddev-generated line, but it’s recommended to use a separate .ddev/docker-compose.minio_extra.yaml file for overrides, for example:

services:
  minio:
    command: server --console-address :9090 --address :10101

configs:
  mc-config.json:
    content: |
      {
        "version": "10",
        "aliases": {
          "minio": {
            "url": "http://localhost:10101",
            "accessKey": "ddevminio",
            "secretKey": "ddevminio",
            "api": "s3v4",
            "path": "auto"
          }
        }
      }

Credits

Developed and maintained by Oblak Studio