Skip to content

Commit

Permalink
Merge pull request #231 from SPYFF/build-note-debian
Browse files Browse the repository at this point in the history
note: Mention gcc-multilib as possible dependency
  • Loading branch information
mitchellh authored Jan 1, 2025
2 parents b62b3ef + 7a10398 commit 2ea94a1
Showing 1 changed file with 25 additions and 19 deletions.
44 changes: 25 additions & 19 deletions docs/install/build.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -70,18 +70,33 @@ Required dependencies:
* `libadwaita`
* `pkg-config`

On Ubuntu and Debian, use:
#### Arch Linux

```sh
sudo apt install libgtk-4-dev libadwaita-1-dev git
sudo pacman -S gtk4 libadwaita
```

On Arch Linux, use
#### Debian and Ubuntu

```sh
sudo pacman -S gtk4 libadwaita
sudo apt install libgtk-4-dev libadwaita-1-dev git
```

On Debian unstable/testing, the `gcc-multilib` package is also required
for building.

<Note>
**A recent GTK is required for Ghostty to work with Nvidia (GL) drivers
under x11.** Ubuntu 22.04 LTS has GTK 4.6 which is not new enough. Ubuntu 23.10
has GTK 4.12 and works. From [this discussion](https://discourse.gnome.org/t/opengl-context-version-not-respected-on-gtk4-rs/12162?u=cdehais)
the problem was fixed in GTK by Dec 2022. Also, if you are a BTRFS user, make
sure to manually upgrade your Kernel (6.6.6 will work). The stock kernel in
Ubuntu 23.10 is 6.5.0 which has a bug which
[causes zig to fail its hash check for packages](https://github.com/ziglang/zig/issues/17282).
</Note>

#### Fedora

On Fedora variants, use

```sh
Expand All @@ -94,33 +109,24 @@ On Fedora Atomic variants, use
rpm-ostree install gtk4-devel zig libadwaita-devel
```

On Gentoo, use
#### Gentoo

```sh
emerge -av libadwaita gtk
```

On Solus, use
#### openSUSE Tumbleweed

```sh
sudo eopkg install libgtk-4-devel libadwaita-devel perl-extutils-pkgconfig
sudo zypper install gtk4-tools libadwaita-devel pkgconf-pkg-config zig
```

On OpenSuse Tumbleweed, use
#### Solus

```sh
sudo zypper install gtk4-tools libadwaita-devel pkgconf-pkg-config zig
sudo eopkg install libgtk-4-devel libadwaita-devel perl-extutils-pkgconfig
```

<Note>
**A recent GTK is required for Ghostty to work with Nvidia (GL) drivers
under x11.** Ubuntu 22.04 LTS has GTK 4.6 which is not new enough. Ubuntu 23.10
has GTK 4.12 and works. From [this discussion](https://discourse.gnome.org/t/opengl-context-version-not-respected-on-gtk4-rs/12162?u=cdehais)
the problem was fixed in GTK by Dec 2022. Also, if you are a BTRFS user, make
sure to manually upgrade your Kernel (6.6.6 will work). The stock kernel in
Ubuntu 23.10 is 6.5.0 which has a bug which
[causes zig to fail its hash check for packages](https://github.com/ziglang/zig/issues/17282).
</Note>

<Warning>
GTK 4.14 on Wayland has a bug which may cause an immediate crash.
There is an
Expand Down

0 comments on commit 2ea94a1

Please sign in to comment.