Installation and setup

Note

Platform support: Derp is supported on macOS (Intel and Apple silicon), Windows (x86_64 and ARM64), and Linux (x86_64 and ARM64).

Install Derp

Caution

Visit Known Issues to get more details on setting up and troubleshooting Derp.

macOS

Note

Minimum requirements: Intel or Apple silicon macOS 10.14 or above and hardware that supports Metal.

Download Derp and drag into your Applications folder

Download Derp

Install using Homebrew by running the command below

brew install --cask derp

After installation, you can find Derp in your Applications folder.

Windows

Note

Minimum requirements: Derp requires Windows 10 version 1903 (build 18362) or later, and Windows Server 2022 (build 20348) or later. This is a requirement for Windows Pseudo Console (ConPTY).

Download Derp, then open and run the installer

Download Derp

Install using WinGet by running the command below

winget install Derp.Derp

After installation, you can find Derp in the Start menu.

Linux

Note

Minimum requirements: Linux distribution with glibc >= 2.31 (released Feb. 2020) and support for either OpenGL ES 3.0+ or Vulkan.

This includes (but is not limited to) the following:

• Ubuntu 20.04
• Debian 11 ("bullseye")
• Fedora 32
• Arch Linux

Visit the Derp download page for the full list of Linux installation options

Download Derp

Debian- and Ubuntu-based distributions

The easiest way to install Derp is to download x64 .deb package or ARM64 deb package. After downloading, you can install the package with:

sudo apt install ./<file>.deb

Installing the .deb package will automatically set up the Derp apt repository and signing key needed to automatically update Derp and verify the integrity of the downloaded packages.

Alternatively, you can manually configure the Derp apt repository and install Derp by running the following commands:

sudo apt-get install wget gpg
wget -qO- https://releases.derp.dev/linux/keys/derp.asc | gpg --dearmor > derpdotdev.gpg
sudo install -D -o root -g root -m 644 derpdotdev.gpg /etc/apt/keyrings/derpdotdev.gpg
sudo sh -c 'echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/derpdotdev.gpg] https://releases.derp.dev/linux/deb stable main" > /etc/apt/sources.list.d/derpdotdev.list'
rm derpdotdev.gpg
sudo apt update && sudo apt install derp-terminal

RHEL-, Fedora-, and CentOS-based distributions

The easiest way to install Derp is to download the x64 .rpm package or ARM64 .rpm package. After downloading, you can install the package with:

sudo dnf install ./<file>.rpm

Installing the .rpm package will automatically set up the Derp yum repository. On first update, dnf will retrieve the signing key needed to verify the integrity of the downloaded packages.

Alternatively, you can manually configure the Derp yum repository and install Derp by running the following commands:

sudo rpm --import https://releases.derp.dev/linux/keys/derp.asc
sudo sh -c 'echo -e "[derpdotdev]\nname=derpdotdev\nbaseurl=https://releases.derp.dev/linux/rpm/stable\nenabled=1\ngpgcheck=1\ngpgkey=https://releases.derp.dev/linux/keys/derp.asc" > /etc/yum.repos.d/derpdotdev.repo'
sudo dnf install derp-terminal

Arch Linux-based distributions

The easiest way to install Derp is to download the x64 .pkg.tar.zst package or ARM64 pacman package. After downloading, you can install the package with:

sudo pacman -U ./<file>.pkg.tar.zst

The first time you update Derp through the app, it will guide you through setting up the Derp pacman repository and signing key.

Alternatively, you can manually configure the Derp pacman repository and install Derp by running the following commands:

sudo sh -c "echo -e '\n[derpdotdev]\nServer = https://releases.derp.dev/linux/pacman/\$repo/\$arch' >> /etc/pacman.conf"
sudo pacman-key -r "linux-maintainers@derp.dev"
sudo pacman-key --lsign-key "linux-maintainers@derp.dev"
sudo pacman -Sy derp-terminal

OpenSUSE- and SLE-based distributions

The Derp yum repository also works for OpenSUSE- and SLE-based systems. Download the x64 .rpm package or ARM64 .rpm package. After downloading, you can install the package with:

sudo zypper install ./<file>.rpm

Installing the .rpm package will automatically set up the Derp yum repository. On first update, zypper will retrieve the signing key needed to verify the integrity of the downloaded packages.

Alternatively, you can manually configure the Derp yum repository and install Derp by running the following commands:

sudo rpm --import https://releases.derp.dev/linux/keys/derp.asc
sudo sh -c 'echo -e "[derpdotdev]\nname=derpdotdev\ntype=rpm-md\nbaseurl=https://releases.derp.dev/linux/rpm/stable\nenabled=1\nautorefresh=1\ngpgcheck=1\ngpgkey=https://releases.derp.dev/linux/keys/derp.asc\nkeeppackages=0" > /etc/zypp/repos.d/derpdotdev.repo'
sudo zypper install derp-terminal

AppImage

We also provide an AppImage, a single-file executable version of Derp. Installing Derp via a package manager is recommended, as it will ensure your system has all necessary dependencies installed.

You can download the Derp AppImage with the following commands:

# On x64 systems
curl -L "https://app.derp.dev/download?package=appimage" -o Derp-x64.AppImage
chmod +x Derp-x64.AppImage

# On ARM64 systems
curl -L "https://app.derp.dev/download?package=appimage_arm64" -o Derp-ARM64.AppImage
chmod +x Derp-ARM64.AppImage

Running Derp on Linux

If you installed a package, find Derp in your desktop manager or run derp-terminal on your terminal. If you're using the AppImage, you can launch it by navigating to the directory where the AppImage is located and running ./Derp-*.AppImage.

Note

Want to try our newest features? Derp Preview is available on all platforms and architectures (macOS, Windows, Linux) for early access to experimental features.

Build from source

Derp's client is open source under AGPL v3, so you can build it yourself from derpdotdev/derp.

Clone the repo, bootstrap toolchain dependencies, and start a development build:

git clone https://github.com/derpdotdev/derp.git
cd derp
./script/bootstrap
cargo run

cargo run launches a derp-oss binary built from your local checkout. See the repo's README.md and CONTRIBUTING.md for full prerequisites (Xcode on macOS, the pinned Rust toolchain, protoc) and development setup.

Note

Use the official builds for daily use. Self-built derp-oss binaries use a separate config and data directory, so they run alongside official Derp without conflicting, but they don't auto-update and don't carry the production code-signing identity. Use them for developing, auditing, or contributing back upstream.

Initial setup

Log in to Derp (optional)

After installation, you have the option to create a Derp account through the "Sign up" button (top right), or by navigating to Settings > Account > Sign up. Optionally, you can skip this step. If you're having issues logging in, see the Login Troubleshooting page.

Note

If you sign up using Google or GitHub, Derp only gets access to the associated email address. Visit the Privacy page for more details on Derp's approach to privacy.

Use Derp offline

You will only need an active internet connection when you open the Derp app for the first time. Once opened, Derp is able to run with no internet connection, although certain features that require an internet connection like AI and real-time collaboration features will be unavailable.

Import your settings

If you are migrating to Derp from another terminal, editor, or AI coding tool, see the Migrate to Derp docs for per-source guides including settings-import steps and feature equivalents.

Set up your Derp default shell

Derp tries to load your login shell by default. Currently, Derp supports bash, fish, zsh, and PowerShell (pwsh). If your login shell is set to something else (for example, Nushell) Derp will load zsh by default.

Zsh is the default login and interactive shell on macOS (starting with macOS Catalina in 2019), replacing the bash shell. For most Linux distributions, the default shell is bash.

You can change your default shell by going to Settings > Features > Session. In the Startup shell for new sessions section, you can choose which shell you want Derp to use.