docs/source/includes/macos/quickstart.rst

This procedure deploys a Single-Node Single-Drive <minio-installation-comparison> MinIO server onto MacOS for early development and evaluation of MinIO Object Storage and its S3-compatible API layer.

For instructions on deploying to production environments, see deploy-minio-distributed.

Prerequisites

• Read, write, and execute permissions for the user's home directory
• Familiarity with using the Terminal

Procedure

1. Install the MinIO Server

2. Launch the MinIO Server

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.

4. (Optional) Install the MinIO Client

   The MinIO Client <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 <minio-users>
   • The Secret Key for a MinIO user <minio-users>

   For additional details about this command, see alias.

section-next-steps

Next Steps

• Connect your applications to MinIO <minio-drivers>
• Configure Object Retention <minio-object-retention>
• Configure Security <minio-authentication-and-identity-management>
• Deploy MinIO for Production Environments <deploy-minio-distributed>