56 lines
2.0 KiB
Markdown
56 lines
2.0 KiB
Markdown
---
|
|
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.
|
|
:::
|
|
|
|
<!--@include: ./reusables.md{44,51}-->
|
|
|
|
## 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:
|
|
- [Docker Desktop](https://www.docker.com/products/docker-desktop/)
|
|
- [MiniKube](https://minikube.sigs.k8s.io/docs/start/?arch=%2Fmacos%2Farm64%2Fstable%2Fhomebrew)
|
|
::: tip
|
|
It's recommended to install via `homebrew`.
|
|
:::
|
|
|
|
## 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
|
|
|
|
|
|
2. Click **Apply & restart** to implement the changes.
|
|
## Install Olares
|
|
In terminal, run the following command:
|
|
|
|
<!--@include: ./reusables.md{4,37}-->
|
|
|
|
<!--@include: ./activate-olares.md-->
|
|
|
|
<!--@include: ./log-in-to-olares.md-->
|
|
|
|
<!--@include: ./reusables.md{38,42}--> |