Default Installation

Clone the repository:

$ git clone

Building with Stack

Use Stack to install Smos with the default configuration:

$ stack install smos

Troubleshooting on Arch linux

Do not install stack or any other haskell packages using pacman. This is unlikely to build at all and will most likely cause in bugs if it does. Instead, install stack by following the documentation on this page

Building with Nix

If you are building with nix, you probably know what you are doing. Start with a regular build, and go from there using the multiple results:

$ nix-build nix/release.nix


When you first run a smos executable that has been built with Nix, you may get an error like the following:

smos: setupTerm: Couldn't look up terminfo entry "rxvt-unicode-256color"

In this case, you can probably solve the problem by setting the TERM variable to xterm:

$ TERM=xterm ./result/bin/smos

Custom installation

Should you wish to customise your smos installation, or customise the smos build entirely, then follow the appropriate guides here or here, respectively.