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

   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 AIStor pricing page and select Get Started under the Free tier to obtain a free license. The free tier license allows you to run 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 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. 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