---
title: "Download and install"
description: "在 macOS 上安装 LocalStack，自动发现并打开你的本地开发站点。"
---

> Documentation Index
> Fetch the complete documentation index at: https://localstack.pwp.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Download and install

LocalStack is a native macOS menu bar app that gathers running local development sites you can open in a browser.

## Download LocalStack

The current public release is **0.2.3-beta.2** for **macOS 15 or newer**. The DMG includes a universal Apple Silicon and Intel app. You do not need Xcode, Rust, or Node.js to use it.

[Download the universal macOS DMG](https://github.com/backrunner/localstack/releases/download/v0.2.3-beta.2/LocalStack-0.2.3-beta.2.dmg) · [View release notes and checksums](https://github.com/backrunner/localstack/releases/tag/v0.2.3-beta.2)

1. 下载并打开 DMG。
2. 将 LocalStack 安装到「应用程序」，然后启动。也可以在 DMG 内双击应用，使用内置安装器。
3. 点击菜单栏里的三层堆叠图标，打开服务面板。
4. 照常启动一个本地开发服务器，例如运行项目自己的 `npm run dev`。

LocalStack 验证页面和进程后，站点会出现在列表里。首次使用不需要为项目添加配置。

## Next steps

- [Use the menu bar panel](/docs/usage)：搜索、打开、复制地址、停止服务和快捷键。
- [How discovery works](/docs/discovery)：Learn which services appear and how to troubleshoot missing services.
- [Add Vite or TypeScript SDK integration](/docs/vite)：自定义服务名称与项目路径。
- [Use the CLI and MCP](/docs/cli)：把本地服务接入终端、脚本和编程助手。
- [Manage automatic updates](/docs/updates)：选择 Stable 或 Beta 通道。

## Build from source

开发需要 Xcode 26+、Swift 6.2+，构建 CLI 需要 Rust，构建 TypeScript 包需要 Node.js 20+。

```bash
git clone https://github.com/backrunner/localstack.git
cd localstack
Scripts/compile_and_run.sh
```

使用 `make package-app` 构建应用包，或使用 `make package-dmg` 构建磁盘映像。本地临时签名可通过 `SIGN_IDENTITY=-` 指定。See the repository for the complete release and notarization process. [macOS 发布文档](https://github.com/backrunner/localstack/blob/main/docs/macos-release.md)。

Source: https://localstack.pwp.sh/docs/en