Installing Inko

  1. Officially supported platforms
  2. Installing using ienv (recommended)
  3. Installing using Homebrew
  4. Installing from Git

Officially supported platforms

Inko supports any Unix-like platform, such as Linux, Mac OS, or BSD.

Inko also supports Windows, but this requires the use of a Unix like compatibility layer such as MSYS2 or Linux for Windows. Currently we only provide official support for MSYS2 environments.

Inko requires a 64-bits platform, 32-bits is not supported.

ienv is the official version manager of Inko. Using ienv you can easily install, remove, and use different versions of Inko during development. ienv only supports Unix platforms. Using ienv, you can install the latest version of Inko as follows:

ienv install latest

For more information, refer to the "Using ienv" guide.

Installing using Homebrew

Inko is provided as a default formula in Homebrew, allowing you to install Inko as follows:

brew install inko

This formula is maintained by Homebrew and its contributors. For issues specific to the formula (e.g. it doesn't work on a certain version of macOS), please report issues in the homebrew-core issue tracker.

Installing from Git

First clone the Git repository:

git clone https://gitlab.com/inko-lang/inko.git

We can then install everything by running the following:

sudo make install

This will try to install Inko in a variety of directories relative to /usr. If you don't like this, you can change the prefix as follows:

make install PREFIX=~/.local

This will then install Inko in ~/.local. The IVM executable will then be located in ~/.local/bin/ivm, and the runtime and compiler will be in ~/.local/lib/inko.

When installing from source, you need to manually tell the inko or inkoc executable where the runtime (the core plus standard library) is located. The easiest way of doing this is by setting INKOC_HOME to the directory containing the runtime. For example, if Inko is installed in ~/.local/share/inko you would use this variable as follows:

INKOC_HOME=~/.local/share/inko/lib/inko inko program_here.inko

To persist this variable you can add it to your shell's configuration file such as ~/.bashrc for Bash, and ~/.config/fish/config.fish for Fish.