Deploy AIStor on macOS

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, 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

   Log in to SUBNET and select the License button in the Deployments view.

   

   Download this file as minio.license onto your local host machine, such as ~/minio/minio.license

   License Management

   Starting with AIStor Server RELEASE.2025-12-20T04-58-37Z, deployments can start without a license in safe mode (read-only access). For full functionality, you must install a valid license.

   After deployment starts, you can register with SUBNET and apply your license:

   mc license register ALIAS --license /path/to/minio.license
      

   For license renewal, expiration details, and safe mode restrictions, see Licenses.

3. 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
   

4. Connect to the deployment

   You can connect to the deployment using the built-in AIStor Server console in a browser, by using the MinIO mc command-line tool, or by using an S3-compatible SDK:

   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. Download the mc tool to your local host machine:

      The mv command may require sudo permissions.

      Homebrew

      brew install minio/aistor/mc
      

      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
      

      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
      

   2. Create a new alias for the AIStor server:

      mc alias set myaistor http://localhost:9000
      

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

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