Installation Guidelines#

This is not going to give specific instructions, because I have not tested Unholy on many machines yet.


First and formost, you need a Docker daemon somewhere.

Additionally, you need the following software installed locally:

  • Git

  • socat

  • Docker CLI

  • Neovide

  • Python (3.10 or later)

Note that while you do not need a local Docker daemon running, your Docker client must already be connected to the daemon and functional. (Unholy supports Docker Contexts and it’s suggested to use them for managing daemon connections.)

Installing Unholy#

Unholy can be installed through Python. pipx is suggested.

With pipx, installation is:

$ pipx install unholy

Initial Configuration#

Besides the aforementioned Docker client credentials, no initial configuration of Unholy is required.