Skip to main content

​
Installing Termy

This guide will help you install Termy on your platform and verify the installation.
Termy is not yet code-signed. You may see security warnings on first launch - see the platform-specific instructions below for how to resolve them.

​
Download Termy

Download the latest release from the GitHub Releases page or visit termy.run. Choose the appropriate asset for your platform:
  • macOS: .dmg file
  • Windows: Setup.exe installer
  • Linux: .AppImage or .tar.gz

​
Platform-Specific Installation

​
macOS Installation

1

Download the DMG

Download the .dmg file from the releases page.
2

Install the Application

  1. Open the downloaded .dmg file
  2. Drag Termy.app into your Applications folder
3

Handle Gatekeeper Warning

Because Termy is not yet code-signed, macOS Gatekeeper will block the first launch.To bypass the warning:
sudo xattr -d com.apple.quarantine /Applications/Termy.app
Then launch Termy from Applications.
4

Launch Termy

Open Termy from your Applications folder or use Spotlight (Cmd+Space, type “Termy”).
You can also install via Homebrew once a cask is available.

​
Verify Installation

After installation, verify that Termy is installed correctly: 
termy --version
You should see output showing the Termy version (e.g., 0.1.40).
If the termy command is not found, you may need to add the installation directory to your PATH. See the platform-specific instructions above.

​
System Requirements

Before installing, ensure your system meets these requirements:
  • Operating System: macOS 10.15+, Windows 10/11, or modern Linux distribution
  • GPU: OpenGL support required (most modern GPUs, including integrated graphics)
  • Memory: 4GB+ RAM recommended
  • Display: Any resolution (hidpi/retina displays supported)

​
Troubleshooting

​
macOS: “App is damaged” error

If you see an error that the app is damaged, run: 
sudo xattr -d com.apple.quarantine /Applications/Termy.app

​
Windows: SmartScreen blocks installation

Click More info, then Run anyway to proceed with installation.

​
Linux: Command not found

Make sure the installation directory is in your PATH: 
echo $PATH
If ~/.local/bin is not listed, add it to your shell configuration file.

​
GPU/Graphics Issues

Termy requires OpenGL support. If you experience rendering issues:
  1. Update your GPU drivers
  2. Check that your system supports OpenGL
  3. Try running with debugging: RUST_LOG=info termy

​
Next Steps

Now that Termy is installed, learn how to use it:

Quickstart Guide

Learn the basics and start using Termy

Configuration

Customize Termy to match your preferences

Build docs developers (and LLMs) love

Get started for freeTalk to us