Quickstart for Mac OSX

minio

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

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 standalone MinIO server for MacOS and make it executable.
```
curl -O https://dl.min.io/server/minio/release/darwin-arm64/minio
chmod +x minio   
```
Binary - amd64

Open a Terminal, then use the following commands to download the standalone MinIO server for MacOS and make it executable.
```
curl -O https://dl.min.io/server/minio/release/darwin-amd64/minio
chmod +x minio
```

Launch the minio server

From the Terminal, use this command 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.

~/minio server ~/data --console-address :9090

If you installed with Homebrew, do not include the ~/ at the beginning of the command.

The minio server process prints its output to the system console, similar to the following:

API: http://192.0.2.10:9000  http://127.0.0.1:9000
RootUser: minioadmin
RootPass: minioadmin

Console: http://192.0.2.10:9090 http://127.0.0.1:9090
RootUser: minioadmin
RootPass: minioadmin

Command-line: https://docs.min.io/docs/minio-client-quickstart-guide
   $ mc alias set myminio http://192.0.2.10:9000 minioadmin minioadmin

Documentation: https://docs.min.io

WARNING: Detected default credentials 'minioadmin:minioadmin', we recommend that you change these values with 'MINIO_ROOT_USER' and 'MINIO_ROOT_PASSWORD' environment variables.

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:9090 http://127.0.0.1:9090 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.
(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.

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>

6.6 KiB Raw Permalink Blame History

Quickstart for Mac OSX

Prerequisites

Procedure

Next Steps

6.6 KiB

Raw Permalink Blame History