1---
 2title: Building Zed for FreeBSD
 3description: "Guide to building zed for freebsd for Zed development."
 4---
 5
 6# Building Zed for FreeBSD
 7
 8FreeBSD is not currently a supported platform, so this guide is a work in progress.
 9
10## Repository
11
12Clone the [Zed repository](https://github.com/zed-industries/zed).
13
14## Dependencies
15
16- Install the necessary system packages and rustup:
17
18  ```sh
19  script/freebsd
20  ```
21
22  If preferred, you can inspect [`script/freebsd`](https://github.com/zed-industries/zed/blob/main/script/freebsd) and perform the steps manually.
23
24## Building from source
25
26Once the dependencies are installed, you can build Zed using [Cargo](https://doc.rust-lang.org/cargo/).
27
28For a debug build of the editor:
29
30```sh
31cargo run
32```
33
34And to run the tests:
35
36```sh
37cargo test --workspace
38```
39
40In release mode, the primary user interface is the `cli` crate. You can run it in development with:
41
42```sh
43cargo run -p cli
44```
45
46### WebRTC Notice
47
48Building `webrtc-sys` on FreeBSD currently fails due to missing upstream support and unavailable prebuilt binaries. As a result, collaboration features that depend on WebRTC (audio calls and screen sharing) are temporarily disabled.
49
50See [Issue #15309: FreeBSD Support] and [Discussion #29550: Unofficial FreeBSD port for Zed] for more.
51
52## Troubleshooting
53
54### Cargo errors claiming that a dependency is using unstable features
55
56Try `cargo clean` and `cargo build`.