# Install xinit with Homebrew, apk, apt, dnf, MacPorts, Nix, zypper

Start the X Window System server. Version 1.4.4 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:xinit
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install xinit
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install xinit
```

  Evidence: MacPorts ports tree: x11/xinit/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add xinit
```

  Evidence: Alpine Linux edge package indexes: xinit from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install xinit
```

  Evidence: Debian stable package indexes: xinit from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install xorg-x11-xinit
```

  Evidence: Fedora Rawhide package metadata: xorg-x11-xinit from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#xinit
```

  Evidence: nixpkgs package indexes: pkgs/by-name/xi/xinit/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- zypper (92%):

```sh
sudo zypper install xinit
```

  Evidence: openSUSE Tumbleweed package metadata: xinit from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## Package facts

- **Package key:** brew:xinit
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/xinit>
- **Version:** 1.4.4
- **Source summary:** Start the X Window System server
- **Homepage:** <https://gitlab.freedesktop.org/xorg/app/xinit>
- **Repository:** <https://gitlab.freedesktop.org/xorg/app/xinit>
- **Upstream docs:** <https://www.x.org/archive/X11R7.5/doc/man/man1/startx.1.html>
- **License:** MIT AND APSL-2.0
- **Source archive:** <https://www.x.org/releases/individual/app/xinit-1.4.4.tar.xz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- font_cache (cli)
- startx (cli)
- xinit (cli)
- font_cache (alias)
- startx (alias)
- xinit (alias)

## Dependencies

- libx11
- quartz-wm
- xauth
- xmodmap
- xrdb
- xterm

## Build dependencies

- lndir
- mkfontscale
- pkgconf
- tradcpp

## Install behavior

- Post-install hook: not defined
- Service: declared
- Caveats: To start privileged xinit now and restart at login: sudo brew services start xinit --file=$HOMEBREW_PREFIX/opt/xinit/homebrew.mxcl.privileged_startx.plist
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.4.4
- Local data: ok
- Upstream repository: https://gitlab.freedesktop.org/xorg/app/xinit
- info: No package-manager update timestamp was available.
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

xinit is the small X.Org session bootstrapper that starts an X server and an initial client program. Its companion script `startx` wraps xinit for the common case of manually starting a single X session from a text login instead of using a display manager.

### Project history

xinit belongs to the old X client/server world where starting a graphical session meant launching the server and one controlling client. The X.Org manual defines it as the X Window System initializer for systems not using a display manager such as xdm, or for environments that use multiple window systems. When the first client exits, xinit kills the X server and terminates.

The tool's behavior has remained intentionally simple: if no client is given it looks for `~/.xinitrc`, otherwise it falls back to a default xterm; if no server is given it looks for `~/.xserverrc`, otherwise it runs `X :0`. `startx` adds a friendlier shell-script layer, choosing `.xinitrc` and `.xserverrc` files and passing server options after `--`.

### Adoption history

xinit was historically central for users who logged into a console and then started X manually. Display managers such as xdm, gdm, and kdm became the common desktop login path, but xinit/startx remained the minimal, packageable fallback for custom window-manager setups, recovery environments, lightweight desktops, and multi-server experiments.

The Linux Documentation Project's X Window User HOWTO captures the traditional split: X sessions are usually started either by a display manager at graphical login or manually from a text console with startx, which is a wrapper around xinit. That is the adoption pattern that kept xinit packaged even after full desktop environments hid it from most users.

### How it is used

Users normally run `startx`, customize `~/.xinitrc` to start clients and leave the final long-lived program, usually a window manager or session manager, in the foreground, and optionally customize `~/.xserverrc` for server startup. Direct `xinit` usage is for explicit client/server combinations, alternate displays, Xvnc-style servers, or low-level troubleshooting.

The package is small but important because it owns the conventional files and shell behavior around manual X startup. Without it, a minimal X.Org install may have an X server and window manager but no standard way for a non-display-manager login to tie them together.

### Why package nerds care

xinit is a perfect package-nerd system utility: tiny, old, boring, and still the glue for a whole class of X11 sessions. It encodes decades of Unix desktop convention in a couple of executable entry points and dotfiles.

Its significance is also diagnostic. When an X session fails before the desktop stack is running, xinit/startx gives maintainers and users a narrow, inspectable path through server arguments, client startup, environment variables, and foreground process lifetime.

### Timeline

- X11 era: xinit becomes the manual initializer pattern for starting an X server and first client outside a display manager.
- X11R6/X11R7 documentation era: `startx` is documented as a front end to xinit for a single X Window System session.
- 2018-07-29: the xorg/app/xinit project appears in freedesktop.org GitLab metadata, reflecting the modern X.Org hosting location.
- 2026: freedesktop.org GitLab metadata still shows activity on the xinit project.

### Related projects

- startx is the user-facing wrapper script shipped with xinit.
- Xorg or another X server is the server process xinit starts.
- xdm, gdm, and kdm are display-manager alternatives that start X sessions without the user manually invoking xinit.
- twm, xterm, and lightweight window managers are classic clients used in `.xinitrc` examples and fallback sessions.

### Sources

- <https://gitlab.freedesktop.org/api/v4/projects/xorg%2Fapp%2Fxinit>
- <https://gitlab.freedesktop.org/xorg/app/xinit>
- <https://tldp.org/HOWTO/XWindow-User-HOWTO/runningx.html>
- <https://xorg.freedesktop.org/archive/X11R6.7.0/doc/startx.1.html>
- <https://xorg.freedesktop.org/archive/X11R7.5/doc/man/man1/xinit.1.html>


## Security Notes

broad file, network, media, or database tool signal. formula declares a Homebrew service.

- **Geiger risk:** orange / medium
- broad file, network, media, or database tool signal
- formula declares a Homebrew service


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: $(HOME)/.xinitrc, $(HOME)/.xserverrc, /usr/lib/X11/xinit/xinitrc, /usr/lib/X11/xinit/xserverrc
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** xinit
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Debian apt - xinit - 1.4.2-1: normalized package name match | Debian stable package indexes: xinit from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | X server initialisation tool
- Nix - xinit: normalized package name match | nixpkgs package indexes: pkgs/by-name/xi/xinit/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - xinit - 1.4.1-0ubuntu5: normalized package name match | Ubuntu 24.04 LTS package indexes: xinit from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | X server initialisation tool
- apk - xinit - 1.4.4-r0: normalized package name match | Alpine Linux edge package indexes: xinit from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | X.Org initialisation program | https://xorg.freedesktop.org/
- apk - xinit-doc - 1.4.4-r0: normalized package name match | Alpine Linux edge package indexes: xinit-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | X.Org initialisation program (documentation) | https://xorg.freedesktop.org/
- dnf - xorg-x11-xinit - 1.4.3-4.fc44: normalized package name match | Fedora Rawhide package metadata: xorg-x11-xinit from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | X.Org X11 X Window System xinit startup scripts | https://www.x.org
- zypper - xinit - 1.4.4-1.3: normalized package name match | openSUSE Tumbleweed package metadata: xinit from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | X Window System initializer | https://xorg.freedesktop.org/
- MacPorts - xinit: normalized package name match | MacPorts ports tree: x11/xinit/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [quartz-wm](https://www.automicvault.com/pkg/brew/quartz-wm/) - Runtime dependency declared by Homebrew.
- [xauth](https://www.automicvault.com/pkg/brew/xauth/) - Runtime dependency declared by Homebrew.
- [xmodmap](https://www.automicvault.com/pkg/brew/xmodmap/) - Runtime dependency declared by Homebrew.
- [xrdb](https://www.automicvault.com/pkg/brew/xrdb/) - Runtime dependency declared by Homebrew.
- [xterm](https://www.automicvault.com/pkg/brew/xterm/) - Runtime dependency declared by Homebrew.
- [lndir](https://www.automicvault.com/pkg/brew/lndir/) - Build dependency declared by Homebrew.
- [mkfontscale](https://www.automicvault.com/pkg/brew/mkfontscale/) - Build dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [tradcpp](https://www.automicvault.com/pkg/brew/tradcpp/) - Build dependency declared by Homebrew.
- [xdpyinfo](https://www.automicvault.com/pkg/brew/xdpyinfo/) - Shares av.db curated category or tags: cli, display-server, system, x11, xorg.
- [xorg-server](https://www.automicvault.com/pkg/brew/xorg-server/) - Shares av.db curated category or tags: cli, display-server, system, x11, xorg.
- [libxcvt](https://www.automicvault.com/pkg/brew/libxcvt/) - Shares av.db curated category or tags: cli, system, x11, xorg.
- [libxpm](https://www.automicvault.com/pkg/brew/libxpm/) - Shares av.db curated category or tags: cli, system, x11, xorg.
- [xcursorgen](https://www.automicvault.com/pkg/brew/xcursorgen/) - Shares av.db curated category or tags: cli, system, x11, xorg.
- [xeyes](https://www.automicvault.com/pkg/brew/xeyes/) - Shares av.db curated category or tags: cli, system, x11, xorg.
- [xwininfo](https://www.automicvault.com/pkg/brew/xwininfo/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, libx11, server, system, window.

## Combined YAML source

View the package source record on GitHub. [combined/xinit.yml](https://github.com/automic-vault/db/blob/main/combined/xinit.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
