Prerequisites

• Read, write, and execute permissions for the user’s home directory

• Familiarity with using the Terminal

Procedure

1. Install the MinIO Server

   Homebrew

   Open a Terminal and run the following command to install the latest stable MinIO package using Homebrew.

   brew install minio/stable/minio
   

   Important

   If you previously installed the MinIO server using brew install minio, then we recommend that you reinstall from minio/stable/minio instead.

   brew uninstall minio
   brew install minio/stable/minio
   

   Binary - arm64

   Open a Terminal, then use the following commands to download the latest stable MinIO binary, set it to executable, and install it to the system $PATH:

   curl -O https://dl.min.io/server/minio/release/darwin-arm64/minio
   chmod +x ./minio
   sudo mv ./minio /usr/local/bin/
   

   Binary - amd64

   Open a Terminal, then use the following commands to download the latest stable MinIO binary, set it to executable, and install it to the system $PATH:

   curl -O https://dl.min.io/server/minio/release/darwin-amd64/minio
   chmod +x ./minio
   sudo mv ./minio /usr/local/bin/
   

2. Launch the MinIO Server

   From the Terminal, use the minio server to start a local MinIO instance in the ~/data folder. If desired, you can replace ~/data with another location to which the user has read, write, and delete access for the MinIO instance.

   export MINIO_CONFIG_ENV_FILE=/etc/default/minio
   minio server --console-address :9001
   

   Status:         1 Online, 0 Offline.
   API: http://192.168.2.100:9000  http://127.0.0.1:9000
   RootUser: myminioadmin
   RootPass: minio-secret-key-change-me
   Console: http://192.168.2.100:9001 http://127.0.0.1:9001
   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:9000 myminioadmin minio-secret-key-change-me
   
   Documentation: https://min.io/docs/minio/linux/index.html
   

   The API block lists the network interfaces and port on which clients can access the MinIO S3 API. The Console block lists the network interfaces and port on which clients can access the MinIO Web Console.

3. Connect your Browser to the MinIO Server

   Access the MinIO Console by going to a browser (such as Safari) and going to https://127.0.0.1:9000 or one of the Console addresses specified in the minio server command’s output. For example, Console: http://192.0.2.10:9001 http://127.0.0.1:9001 in the example output indicates two possible addresses to use for connecting to the Console.

   While port 9000 is used for connecting to the API, MinIO automatically redirects browser access to the MinIO Console.

   Log in to the Console with the RootUser and RootPass user credentials displayed in the output. These default to minioadmin | minioadmin.

   

   You can use the MinIO Console for general administration tasks like Identity and Access Management, Metrics and Log Monitoring, or Server Configuration. Each MinIO server includes its own embedded MinIO Console.

   

   For more information, see the MinIO Console documentation.

4. (Optional) Install the MinIO Client

   The MinIO Client allows you to work with your MinIO volume from the commandline.

   Homebrew

   Run the following commands to install the latest stable MinIO Client package using Homebrew.

   brew install minio/stable/mc
   

   To use the command, run

   mc {command} {flag}
   

   Binary (arm64)

   Download the standalone MinIO server for MacOS and make it executable.

   curl -O https://dl.min.io/client/mc/release/darwin-arm64/mc
   chmod +x mc
   sudo mv mc /usr/local/bin/mc
   

   To use the command, run

   mc {command} {flag}
   

   Binary (amd64)

   Download the standalone MinIO server for MacOS and make it executable.

   curl -O https://dl.min.io/client/mc/release/darwin-amd64/mc
   chmod +x mc
   sudo mv mc /usr/local/bin/mc
   

   To use the command, run

   mc {command} {flag}
   

   Use mc alias set to quickly authenticate and connect to the MinIO deployment.

   mc alias set local http://127.0.0.1:9000 minioadmin minioadmin
   mc admin info local
   

   The mc alias set takes four arguments:

   • The name of the alias

   • The hostname or IP address and port of the MinIO server

   • The Access Key for a MinIO user

   • The Secret Key for a MinIO user

   For additional details about this command, see mc alias set.