{"id":20329358,"url":"https://github.com/ddev/ddev-minio","last_synced_at":"2025-04-11T20:42:17.487Z","repository":{"id":188092762,"uuid":"678091119","full_name":"ddev/ddev-minio","owner":"ddev","description":"MinIO addon for DDEV","archived":false,"fork":false,"pushed_at":"2025-04-10T19:58:00.000Z","size":693,"stargazers_count":6,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-10T20:43:03.532Z","etag":null,"topics":["ddev","ddev-get","minio"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ddev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-13T16:43:33.000Z","updated_at":"2025-04-10T19:39:01.000Z","dependencies_parsed_at":"2023-09-27T11:17:22.077Z","dependency_job_id":"e8febf22-e3a4-4085-aaab-0551bdc0f489","html_url":"https://github.com/ddev/ddev-minio","commit_stats":null,"previous_names":["oblakstudio/ddev-minio","ddev/ddev-minio"],"tags_count":13,"template":false,"template_full_name":"ddev/ddev-addon-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2Fddev-minio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2Fddev-minio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2Fddev-minio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2Fddev-minio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ddev","download_url":"https://codeload.github.com/ddev/ddev-minio/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248479203,"owners_count":21110839,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ddev","ddev-get","minio"],"created_at":"2024-11-14T20:10:21.117Z","updated_at":"2025-04-11T20:42:17.474Z","avatar_url":"https://github.com/ddev.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# ddev-minio - use MinIO object storage in DDEV\n\n![GitHub release (with filter)](https://img.shields.io/github/v/release/ddev/ddev-minio)\n[![Daily tests](https://github.com/ddev/ddev-minio/actions/workflows/cron_tests.yml/badge.svg)](https://github.com/ddev/ddev-minio/actions/workflows/cron_tests.yml)\n[![semantic-release: angular](https://img.shields.io/badge/semantic--release-angular-e10079?logo=semantic-release)](https://github.com/semantic-release/semantic-release)\n![project is maintained](https://img.shields.io/maintenance/yes/2024.svg)\n\n\u003c/div\u003e\n\nThis repository provides MinIO add-on to [DDEV](https://ddev.readthedocs.io).\n\nIt's based on [MinIO official image](https://hub.docker.com/r/minio/minio) and [DDEV custom compose files](https://ddev.readthedocs.io/en/stable/users/extend/custom-compose-files/)\n\n## Installation\n\nFor DDEV v1.23.5 or above run\n\n```bash\nddev add-on get ddev/ddev-minio\n```\n\nFor earlier versions of DDEV run\n\n```bash\nddev get ddev/ddev-minio\n```\n\nThen restart the project\n\n```bash\nddev restart\n```\n\n## Configuration\n\n### MinIO console\n\nLogin to MinIO console `https://\u003cproject\u003e.ddev.site:9090` login with credentials `ddevminio:ddevminio` and create a bucket.\n\n### File access\n\nProject docker instances can access MinIO api via `http://minio:10101`\n\nDDEV Router is configured to proxy the requests to `https://\u003cproject\u003e.ddev.site:10101` to MinIO S3 Api.\n\nExample URLs for accessing files are\n\n| Bucket   | File path              | Internal URL                                     | External URL                                                    |\n|----------|------------------------|--------------------------------------------------|-----------------------------------------------------------------|\n| `photos` | `vacation/seaside.jpg` | `http://minio:10101/photos/vacation/seaside.jpg` | `https://\u003cproject\u003e.ddev.site:10101/photos/vacation/seaside.jpg` |\n| `music`  | `tron/derezzed.mp3`    | `http://minio:10101/music/tron/derezzed.mp3`     | `https://\u003cproject\u003e.ddev.site:10101/music/tron/derezzed.mp3`     |\n\n## Connecting from PHP\n\n### Installation\n\nSince MinIO is S3 compatible you can use [AWS PHP SDK](https://packagist.org/packages/aws/aws-sdk-php). Install it with composer:\n\n```bash\nddev composer require aws/aws-sdk-php\n```\n\n### Basic usage\n\n```php\n\u003c?php\n\nrequire __DIR__ . '/vendor/autoload.php';\n\n$s3 = new \\Aws\\S3\\S3Client([\n    'endpoint' =\u003e 'http://minio:10101',\n    'credentials' =\u003e [\n        'key' =\u003e 'ddevminio',\n        'secret' =\u003e 'ddevminio',\n    ],\n    'region' =\u003e 'us-east-1',\n    'version' =\u003e 'latest',\n    'use_path_style_endpoint' =\u003e true,\n]);\n\n$bucketName = 'ddev-minio';\n\nif (!$s3-\u003edoesBucketExist($bucketName)) {\n    $s3-\u003ecreateBucket([\n        'Bucket' =\u003e $bucketName,\n    ]);\n}\n\n$s3-\u003eputObject([\n    'Bucket' =\u003e $bucketName,\n    'Key' =\u003e 'ddev-test',\n    'Body' =\u003e 'DDEV Minio is working!',\n]);\n\n$object = $s3-\u003egetObject([\n    'Bucket' =\u003e $bucketName,\n    'Key' =\u003e 'ddev-test',\n]);\n\necho $object['Body'];\n```\n\n## Commands\n\nAddon exposes the following commands\n\n| Command | Usage        | Description                     |\n|---------|--------------|---------------------------------|\n| `minio` | `ddev minio` | Launches the MinIO Console      |\n| `mc`    | `ddev mc`    | Launches the MinIo admin client |\n\n___\n\n**Based on the original [ddev-contrib recipe](https://github.com/ddev/ddev-contrib/tree/master/docker-compose-services/mongodb)**  \n**Developed and maintained by [Oblak Studio](https://github.com/oblakstudio)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddev%2Fddev-minio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fddev%2Fddev-minio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddev%2Fddev-minio/lists"}