Files
Olares/docs/manual/get-started/install-mac-script.md
2026-01-07 16:58:18 +08:00

2.0 KiB

description
description
Step-by-step instructions for installing Olares on macOS systems including prerequisites, installation commands, and activation process.

Install Olares on Mac via the script

This guide explains how to install Olares on macOS using the provided installation script.

:::warning Not for production use Olares on Mac has certain limitations including:

  • Lack of distributed storage support.
  • Inability to add local nodes.

We recommend using it only for development or testing purposes. :::

System compatibility

Make sure your Mac meets the following requirements.

  • Architecture: X86-64 or ARM64.
  • RAM: At least 8 GB of available memory.
  • Storage: At least 150 GB of available SSD storage. ::: warning SSD required The installation will likely fail if an HDD (mechanical hard drive) is used instead of an SSD. :::
  • MacOS: Monterey (12) or later.

::: info GPU limitation Olares GPU acceleration currently supports NVIDIA GPUs only. Consequently, GPU resources cannot be managed or utilized for AI workloads on macOS devices. :::

Before you begin

Ensure you have the following installed:

Set up system environment

  1. In Docker Desktop, navigate to Settings > Resources, and configure as below:

    • CPU limit: Set to at least 4 CPUs
    • Memory limit: Set to at least 9 GB
    • Virtual disk limit: Set to at least 80 GB

    Update resource settings (example)

  2. Click Apply & restart to implement the changes.

Install Olares

In terminal, run the following command: