DEV Community

Viktor Le
Viktor Le

Posted on

How to setup Amazon S3 Compatible Filesystems - MinIO on MacOS for Laravel Application

#laravel #s3 #minio #development

By default, your application's filesystems configuration file contains a disk configuration for the s3 disk. In addition to using this disk to interact with Amazon S3, you may use it to interact with any S3-compatible file storage service , and MiniIO is the greate choice here.

Let's say, the .env file has this block

FILESYSTEM_DISK=s3

AWS_ACCESS_KEY_ID=access_key
AWS_SECRET_ACCESS_KEY=secrete_key
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=xxxxxxx
AWS_ENDPOINT=xxxxxxx
Enter fullscreen mode Exit fullscreen mode

There are two ways to setup MiniIO locally

  1. Set up directly in the localhost Easy step with 1 command 
brew install minio/stable/minio
Enter fullscreen mode Exit fullscreen mode

Then launch the MinIO Server by running the following command. If desired, you can replace ~/data with another localtion of Storage to read, write and delete access for the MinIO instance

export MINIO_CONFIG_ENV_FILE=/etc/default/minio
minio server ~/data --address :9001 ### API (S3 compatible)
minio server ~/data --console-address :9002 ### Web UI (User Interface)
Enter fullscreen mode Exit fullscreen mode

After you run these above commands, it will print out

Status:         1 Online, 0 Offline.
API: http://192.168.2.100:9001  http://127.0.0.1:9001
RootUser: myminioadmin
RootPass: minio-secret-key-change-me
Console: http://192.168.2.100:9002 http://127.0.0.1:9002
RootUser: myminioadmin
RootPass: minio-secret-key-change-me

Command-line: https://min.io/docs/minio/linux/reference/minio-mc.html
   $ mc alias set myminio http://10.0.2.100:9001 myminioadmin minio-secret-key-change-me

Documentation: https://min.io/docs/minio/linux/index.html
Enter fullscreen mode Exit fullscreen mode

Now, you have access_key and secrete_key which is RootUser, and RootPass. And let's paste to the .env file

FILESYSTEM_DISK=s3

AWS_ACCESS_KEY_ID=myminioadmin
AWS_SECRET_ACCESS_KEY=minio-secret-key-change-me
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=<name_bucket_desire>
AWS_ENDPOINT=http://127.0.0.1:9001
Enter fullscreen mode Exit fullscreen mode

You can connect and interact with MinIO from Laravel Application

Open browser with address: http://127.0.0.1:9002, bummmm MinIO UI appears excellently

Image description

  1. Setup by using Docker the docker-compose.yml will look like 
version: '3.8'
services:
  minio:
    image: quay.io/minio/minio:latest  # Or your preferred MinIO image
    container_name: minio
    ports:
      - "9001:9001"  # Expose the MinIO server port
      - "9002:9002"  # Expose the MinIO console port
    environment:
      MINIO_ACCESS_KEY: minioadmin  # Replace with your desired username
      MINIO_SECRET_KEY: minioadmin  # Replace with your desired password
      MINIO_DEFAULT_BUCKETS: "my-test-bucket" # Optional: create a default bucket
    volumes:
      - ./data:/data  # Persistent storage for MinIO data
    command: server /data --address ":9001" --console-address ":9002"  # Start MinIO server with console on port 9001
    restart: unless-stopped  # Restart policy for the container
Enter fullscreen mode Exit fullscreen mode

And all the rest is like the option#1 to connect and interact with MinIO

Reference:

  1. https://laravel-news.com/minio-s3-compliant-storage
  2. https://min.io/docs/minio/macos/index.html

Top comments (0)