Quickstart for Mac OSX

This procedure deploys a Standalone MinIO server onto MacOS for early development and evaluation of MinIO Object Storage and it’s S3-compatible API layer.

Standalone deployments (also called “filesystem mode”) support a subset of MinIO features where redundancy or availability are dependent entirely on the underlying drive or volume.

For instructions on deploying to production environments, see Deploy MinIO in Distributed Mode.

Prerequisites

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

  • Familiarity with using the Terminal

Procedure

  1. Install the MinIO Server

    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
    

    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
    

    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
    
  2. 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.
    
  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: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.

    MinIO Console displaying login screen

    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.

    MinIO Console displaying bucket start screen

    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.

    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}
    

    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}
    

    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.

Next Steps