Deploy MinIO AIStor on macOS

MinIO AIStor is licensed under the MinIO Software License. An active license is required for production deployments.

This section documents steps for installing and managing AIStor Server on macOS™ host machines.

1. Install AIStor Server onto the macOS host

   The easiest way to install AIStor Server on macOS is using Homebrew.

   Alternatively, MinIO AIStor provides binaries for M-series processors (ARM64) and older Intel-based processors (AMD64). Download the binary, set it as executable, and copy it to a location in your $PATH such as /usr/local/bin

   Homebrew

   brew install minio/aistor/minio
   

   M-Series ARM64

   curl --progress-bar -L https://dl.min.io/aistor/minio/release/darwin-arm64/minio -o minio
   chmod +x ./minio
   mv ./minio /usr/local/bin #may require sudo permissions
   
   minio --version
   

   Intel AMD64

   curl --progress-bar -L https://dl.min.io/aistor/minio/release/darwin-amd64/minio -o minio
   chmod +x ./minio
   mv ./minio /usr/local/bin #may require sudo permissions
   
   minio --version
   

2. Retrieve your license file

   MinIO AIStor requires a license to run. You can use an existing license, such as one from SUBNET, or you can request a new MinIO AIStor Free Tier license.

   To request a new MinIO AIStor Free Tier license, go to the MinIO AIStor pricing page and select Get Started under the Free tier to obtain a free license. The free tier license allows you to run MinIO AIStor on a single compute resource with one or more drives.

   Download the license file to ~/minio/minio.license for use in later steps.

   Free tier licenses do not include support. For support options, see the MinIO AIStor pricing page. For more information about licenses, see Licenses.

3. (Optional) Set up TLS

   If you need TLS for your deployment, configure it before starting the server. See Set up network encryption for instructions.

4. Run the Server

   The following command runs the server against the /tmp/minio directory. Specify your preferred folder, drive, or volume path for use with the server:

   minio server /tmp/minio --license ~/minio/minio.license
   

   The output resembles the following:

   MinIO Enterprise Object Store
   API: http://192.168.86.35:9000  http://127.0.0.1:9000
      RootUser: minioadmin
      RootPass: minioadmin
   
   WebUI: http://192.168.86.35:9001 http://127.0.0.1:9001
      RootUser: minioadmin
      RootPass: minioadmin
   
   CLI: https://docs.min.io/enterprise/aistor-object-store/reference/cli/#quickstart
      $ mc alias set 'myaistor' 'http://192.168.86.35:9000' 'minioadmin' 'minioadmin'
   
   Docs: https://docs.min.io/enterprise/aistor-object-store/
   WARN: Detected default credentials 'minioadmin:minioadmin', we recommend that you change these values with 'MINIO_ROOT_USER' and 'MINIO_ROOT_PASSWORD' environment variables
   

5. Install the AIStor Client (mc)

   Homebrew

   brew install minio/aistor/mc
   

   M-Series ARM64

   curl --progress-bar -L https://dl.min.io/aistor/mc/release/darwin-arm64/mc -o mc
   chmod +x ./mc
   mv ./mc /usr/local/bin
   
   mc --version
   

   Intel AMD64

   curl --progress-bar -L https://dl.min.io/aistor/mc/release/darwin-amd64/mc -o mc
   chmod +x ./mc
   mv ./mc /usr/local/bin/
   
   mc --version
   

6. Connect to the deployment

   You can connect to the deployment using the built-in AIStor Console or the AIStor Client (mc).

   MinIO AIStor Console

   Open your browser to the hostname and port of any node in the deployment. The WebUI output from the previous step indicates which hostnames and ports the minio process listens on.

   Log in using the default minioadmin:minioadmin username and password.

   CLI

   1. Create a new alias for the MinIO AIStor server:

      mc alias set myaistor http://localhost:9000
      

   2. Create a bucket and copy a file to that bucket:

      mc mb myaistor/data
      mc cp ~/somefile.txt myaistor/data