Skip to main content

​
Installing Glass

Glass is available for macOS, Linux, and Windows. Choose your installation method based on your operating system and preferences.

​
macOS

Glass supports macOS 12 (Monterey) and later on both Intel and Apple Silicon. Install Glass using Homebrew: 
brew install --cask glass
For preview builds: 
brew install --cask glass@preview

​
Direct Download

Download the latest .dmg from the Glass releases page:
  1. Download Glass.dmg
  2. Open the DMG file
  3. Drag Glass to your Applications folder
  4. Launch Glass from Applications
On first launch, macOS may ask you to verify the app. Go to System Settings > Privacy & Security and click Open Anyway if prompted.

​
Build from Source

For development or custom builds: 
git clone https://github.com/Glass-HQ/Glass.git
cd Glass
./script/bundle-mac-cef debug
./run-glass.sh
See the macOS development guide for detailed build instructions.

​
Linux

Glass supports x86_64 and aarch64 architectures on most modern Linux distributions. Install Glass with a single command: 
curl -f https://glass.dev/install.sh | sh
Install a specific version: 
curl -f https://glass.dev/install.sh | GLASS_VERSION=0.1.0 sh
Install preview builds: 
curl -f https://glass.dev/install.sh | GLASS_CHANNEL=preview sh
The installation script requires curl and sh. It supports Ubuntu, Debian, Fedora, Arch, CentOS, and most major distributions.

​
Package Managers

Using AUR:
yay -S glass-git
# or
paru -S glass-git

​
Build from Source

Build Glass on Linux: 
git clone https://github.com/Glass-HQ/Glass.git
cd Glass
cargo build --release
target/release/glass
See the Linux development guide for dependencies and build requirements.

​
System Requirements

Glass requires:
  • Vulkan 1.3 compatible GPU driver
  • Desktop portals: FileChooser, OpenURI, Secret
  • glibc 2.31 or newer (most distributions from 2020+)

​
Windows

Glass supports Windows 10 (version 1903) and later, including Windows 11. Install using Windows Package Manager: 
winget install -e --id Glass-HQ.Glass
For preview builds: 
winget install -e --id Glass-HQ.Glass.Preview

​
Direct Download

Download the installer from the Glass releases page:
  1. Download Glass-Setup.exe
  2. Run the installer
  3. Follow the installation wizard
  4. Launch Glass from the Start menu

​
Chocolatey

Install using Chocolatey: 
choco install glass

​
Build from Source

Build Glass on Windows: 
git clone https://github.com/Glass-HQ/Glass.git
cd Glass
cargo build --release
target\release\glass.exe
See the Windows development guide for dependencies.

​
System Requirements

  • DirectX 11 compatible GPU (most PCs from 2012+)
  • Current GPU drivers (not Microsoft Basic Display Adapter)
  • 64-bit operating system (x64 or ARM64)

​
CLI Installation

After installing Glass, set up the command-line interface:

​
macOS/Linux

glass --install-cli
This creates a glass symlink in /usr/local/bin (may require sudo).

​
Windows

The CLI is automatically added to PATH during installation. Verify: 
glass --version

​
Verify Installation

Check that Glass is installed correctly: 
glass --version
You should see output like: 
Glass 0.1.0 (based on Zed 0.216.0)

​
Next Steps

Quick Start

Open your first project and learn the basics

Configuration

Customize settings, themes, and keybindings

Extensions

Discover and install extensions

Contributing

Set up Glass for development

​
Uninstalling

To uninstall Glass:
If installed via Homebrew:
brew uninstall --cask glass
If installed manually, delete from Applications and run:
rm -rf ~/.config/glass
rm -rf ~/.local/share/glass

Build docs developers (and LLMs) love

Get started for freeTalk to us