Skip to content

Commit 19a7a3e

Browse files
Claudeclaude
andcommitted
Add changelog and update install docs for Homebrew-native CLI binaries
The Appwrite CLI now ships native compiled binaries via Homebrew for macOS and Linux. Update the install docs to make Homebrew the recommended install path, add Linux Homebrew support, and add a changelog entry announcing the change. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 30dc6d3 commit 19a7a3e

2 files changed

Lines changed: 64 additions & 29 deletions

File tree

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
---
2+
layout: changelog
3+
title: "Appwrite CLI now ships native Homebrew binaries"
4+
date: 2026-04-10
5+
---
6+
7+
The Appwrite CLI installed via [Homebrew](https://brew.sh/) now delivers **native compiled binaries** instead of a Node.js-based package. This means faster startup, no runtime dependencies, and a smaller install footprint on macOS and Linux.
8+
9+
Supported platforms and architectures:
10+
11+
- macOS Apple Silicon (arm64)
12+
- macOS Intel (x64)
13+
- Linux arm64
14+
- Linux x64
15+
16+
Install or upgrade with Homebrew:
17+
18+
```sh
19+
brew install appwrite # new install
20+
brew upgrade appwrite # existing install
21+
```
22+
23+
The CLI is still available via npm (`npm install -g appwrite-cli`) and platform-specific install scripts for environments where Homebrew is not an option.
24+
25+
{% arrow_link href="/docs/tooling/command-line/installation" %}
26+
Read the updated installation docs
27+
{% /arrow_link %}

src/routes/docs/tooling/command-line/installation/+page.markdoc

Lines changed: 37 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -8,33 +8,47 @@ The [Appwrite Command Line Interface (CLI)](https://github.com/appwrite/sdk-for-
88

99
# Getting started {% #getting-started %}
1010

11-
The CLI is packaged both as an [npm module](https://www.npmjs.com/package/appwrite-cli) as well as a [standalone binary](https://github.com/appwrite/sdk-for-cli/releases/latest) for your operating system, making it completely dependency free, platform independent, and language agnostic.
11+
The CLI is packaged as a [native binary](https://github.com/appwrite/sdk-for-cli/releases/latest) for macOS and Linux (via Homebrew), as an [npm module](https://www.npmjs.com/package/appwrite-cli), and as a standalone install script for all platforms.
1212

1313
If you plan to use the CLI to initialize new Appwrite Functions, ensure that [Git is installed](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) on your machine.
1414

15-
## Install with npm {% #install-with-npm %}
15+
## Install with Homebrew (recommended) {% #install-with-homebrew %}
1616

17-
If you have npm set up, run the command below to install the CLI.
17+
On macOS and Linux, [Homebrew](https://brew.sh/) is the recommended way to install the Appwrite CLI. Homebrew delivers a **native compiled binary** for your platform and architecture, so there are no runtime dependencies and startup is instant.
1818

19+
{% tabs %}
20+
{% tabsitem #macos title="macOS" %}
1921
```sh
20-
npm install -g appwrite-cli
22+
brew install appwrite
2123
```
24+
{% /tabsitem %}
2225

23-
## Install with script {% #install-with-script %}
26+
{% tabsitem #linux title="Linux" %}
27+
Install [Homebrew for Linux](https://docs.brew.sh/Homebrew-on-Linux), then run:
2428

25-
For a completely dependency-free installation, the CLI also ships with a convenient installation script for your operating system
29+
```sh
30+
brew install appwrite
31+
```
32+
{% /tabsitem %}
2633

27-
{% tabs %}
28-
{% tabsitem #macos title="macOS" %}
34+
{% /tabs %}
35+
36+
Supported architectures: Apple Silicon (arm64), Intel (x64), Linux arm64, and Linux x64.
2937

30-
Using [Homebrew](https://brew.sh/)
38+
## Install with npm {% #install-with-npm %}
39+
40+
If you have npm set up, you can install the CLI as a Node.js package. This works on any platform where Node.js runs.
3141

3242
```sh
33-
brew install appwrite
43+
npm install -g appwrite-cli
3444
```
3545

36-
or terminal
46+
## Install with script {% #install-with-script %}
3747

48+
The CLI also ships with installation scripts for platforms where Homebrew is not available.
49+
50+
{% tabs %}
51+
{% tabsitem #macos title="macOS" %}
3852
```sh
3953
curl -sL https://appwrite.io/cli/install.sh | bash
4054
```
@@ -66,22 +80,19 @@ curl -sL https://appwrite.io/cli/install.sh | bash
6680
# Update your CLI {% #update-your-cli %}
6781

6882
{% tabs %}
69-
{% tabsitem #npm title="npm" %}
83+
{% tabsitem #homebrew title="Homebrew" %}
7084
```sh
71-
npm install -g appwrite-cli
85+
brew upgrade appwrite
7286
```
7387
{% /tabsitem %}
7488

75-
{% tabsitem #macos title="macOS" %}
76-
77-
Using [Homebrew](https://brew.sh/)
78-
89+
{% tabsitem #npm title="npm" %}
7990
```sh
80-
brew install appwrite
91+
npm install -g appwrite-cli
8192
```
93+
{% /tabsitem %}
8294

83-
or terminal
84-
95+
{% tabsitem #macos title="macOS (script)" %}
8596
```sh
8697
curl -sL https://appwrite.io/cli/install.sh | bash
8798
```
@@ -93,7 +104,7 @@ iwr -useb https://appwrite.io/cli/install.ps1 | iex
93104
```
94105
{% /tabsitem %}
95106

96-
{% tabsitem #linux title="Linux" %}
107+
{% tabsitem #linux title="Linux (script)" %}
97108
```sh
98109
curl -sL https://appwrite.io/cli/install.sh | bash
99110
```
@@ -203,19 +214,16 @@ If you installed Appwrite CLI using NPM, you can use the following command to un
203214
npm uninstall -g appwrite-cli
204215
```
205216

206-
If you installed the Appwrite CLI with brew or the installation script for your operating system, use the following command to uninstall it.
217+
If you installed the Appwrite CLI with Homebrew or the installation script for your operating system, use the following command to uninstall it.
207218

208219
{% tabs %}
209-
{% tabsitem #macos title="macOS" %}
210-
211-
Using [Homebrew](https://brew.sh/)
212-
220+
{% tabsitem #homebrew title="Homebrew (macOS / Linux)" %}
213221
```sh
214222
brew uninstall appwrite
215223
```
224+
{% /tabsitem %}
216225

217-
or terminal
218-
226+
{% tabsitem #macos title="macOS (script)" %}
219227
```sh
220228
rm -f /usr/local/bin/appwrite | bash
221229
```
@@ -236,7 +244,7 @@ scoop uninstall appwrite
236244
```
237245
{% /tabsitem %}
238246

239-
{% tabsitem #linux title="Linux" %}
247+
{% tabsitem #linux title="Linux (script)" %}
240248
```sh
241249
rm -f /usr/local/bin/appwrite | bash
242250
```

0 commit comments

Comments
 (0)