2025-11-19 21:21:20 +00:00
|
|
|
---
|
|
|
|
|
weight: 2
|
|
|
|
|
title: "Installation"
|
|
|
|
|
description: "How to install LocalAI"
|
|
|
|
|
type: chapter
|
|
|
|
|
icon: download
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
LocalAI can be installed in multiple ways depending on your platform and preferences.
|
|
|
|
|
|
2026-04-07 12:42:23 +00:00
|
|
|
## Video Walkthrough
|
|
|
|
|
|
|
|
|
|
[](https://www.youtube.com/watch?v=cMVNnlqwfw4)
|
|
|
|
|
|
2025-11-19 21:21:20 +00:00
|
|
|
## Installation Methods
|
|
|
|
|
|
|
|
|
|
Choose the installation method that best suits your needs:
|
|
|
|
|
|
2026-02-25 07:13:55 +00:00
|
|
|
1. **[Containers](containers/)** ⭐ **Recommended** - Works on all platforms, supports Docker and Podman
|
2025-11-19 21:21:20 +00:00
|
|
|
2. **[macOS](macos/)** - Download and install the DMG application
|
2026-02-24 07:36:25 +00:00
|
|
|
3. **[Linux](linux/)** - Install on Linux using binaries
|
2025-11-19 21:21:20 +00:00
|
|
|
4. **[Kubernetes](kubernetes/)** - Deploy LocalAI on Kubernetes clusters
|
|
|
|
|
5. **[Build from Source](build/)** - Build LocalAI from source code
|
|
|
|
|
|
|
|
|
|
## Quick Start
|
|
|
|
|
|
2026-02-25 07:13:55 +00:00
|
|
|
**Recommended: Containers (Docker or Podman)**
|
2025-11-19 21:21:20 +00:00
|
|
|
|
|
|
|
|
```bash
|
2026-02-25 07:13:55 +00:00
|
|
|
# With Docker
|
2025-11-19 21:21:20 +00:00
|
|
|
docker run -p 8080:8080 --name local-ai -ti localai/localai:latest
|
2026-02-25 07:13:55 +00:00
|
|
|
|
|
|
|
|
# Or with Podman
|
|
|
|
|
podman run -p 8080:8080 --name local-ai -ti localai/localai:latest
|
2025-11-19 21:21:20 +00:00
|
|
|
```
|
|
|
|
|
|
2026-03-14 16:49:36 +00:00
|
|
|
This will start LocalAI. The API will be available at `http://localhost:8080`.
|
2025-11-19 21:21:20 +00:00
|
|
|
|
|
|
|
|
For other platforms:
|
|
|
|
|
- **macOS**: Download the [DMG](macos/)
|
2026-02-24 07:36:25 +00:00
|
|
|
- **Linux**: See the [Linux installation guide](linux/) for binary installation.
|
2025-11-19 21:21:20 +00:00
|
|
|
|
2026-02-25 07:13:55 +00:00
|
|
|
For detailed instructions, see the [Containers installation guide](containers/).
|