How to install

From a Package

Repology maintains a list of various bundled zshdb packages. Below are some specific distributions that contain zshdb.

At the time this documentation was built, here is status that they provide:


Check the link above for more up-to-date information.


On Debian systems, and derivatives, zshdb can be installed by running:

$ sudo apt-get install zshdb

The latest version may not yet be included in the archives. If you are running a stable version of Debian or a derivative, you may need to install zshdb from the backports repository for your version to get a recent version installed.


On OSX systems, you can install from Homebrew or MacPorts.

$  brew install zshdb

From Source


Go to sourceforge and find the most recent version and download a tarball of that.

$ tar -xpf zshdb-xxx.tar.bz2
$ cd zshdb-xxx
$ ./
$ make && make test
$ make install # may need sudo


Many package managers have back-level versions of this debugger. The most recent versions is from the github.

To install from git:

$ git-clone git://
$ cd zshdb
$ ./  # Add configure options. See ./configure --help

If you’ve got a suitable zsh installed, then

$ make && make test

To try on a real program such as perhaps /etc/zsh/zshrc:

$ ./zshdb -L /etc/zsh/zshrc # substitute .../zshrc with your favorite zsh script

To modify source code to call the debugger inside the program:

source path-to-zshdb/zshdb/
# work, work, work.

# start debugging here

Above, the directory path-to_zshdb should be replaced with the directory that is located in. This can also be from the source code directory zshdb or from the directory gets installed directory. The “source” command needs to be done only once somewhere in the code prior to using _Dbg_debugger.

If you are happy and make test above worked, install via:

sudo make install

and uninstall with:

$ sudo make uninstall # ;-)