Installation

Debian#

IXpect can be installed using the Debian packages provided in our Codeberg package repository. IXpect can be installed from the repository following these steps:

stable releasesdevelopment snapshots

# save the repository OpenPGP key
wget -O /usr/share/keyrings/codeberg-ixpect.asc https://codeberg.org/api/packages/ixpect/debian/repository.key

# add sources list entry
echo "deb [signed-by=/usr/share/keyrings/codeberg-ixpect.asc] https://codeberg.org/api/packages/ixpect/debian linux stable" > /etc/apt/sources.list.d/ixpect.list

# update repository and install ixpect
apt update
apt install ixpect

# edit command-line arguments and config file
${EDITOR:-editor} /etc/default/ixpect
${EDITOR:-editor} /etc/ixpect/ixpect.conf.yam

# enable and start ixpect.service unit
systemctl enable --now ixpect.service

# save the repository OpenPGP key
wget -O /usr/share/keyrings/codeberg-ixpect.asc https://codeberg.org/api/packages/ixpect/debian/repository.key

# add sources list entry
echo "deb [signed-by=/usr/share/keyrings/codeberg-ixpect.asc] https://codeberg.org/api/packages/ixpect/debian linux unstable" > /etc/apt/sources.list.d/ixpect.list

# update repository and install ixpect
apt update
apt install ixpect

# edit command-line arguments and config file
${EDITOR:-editor} /etc/default/ixpect
${EDITOR:-editor} /etc/ixpect/ixpect.conf.yam

# enable and start ixpect.service unit
systemctl enable --now ixpect.service

Command-line arguments can be configured be using environment variables in /etc/default/ixpect. The configuration file and the templates directory are located in /etc/ixpect.

Nix#

IXpect can be installed as a nix module. See the full options reference for all available options.

{
  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs/nixos-25.05";
    ifstate = {
      url = "git+https://codeberg.org/ixpect/ixpect/<version>";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = { self, nixpkgs, ifstate, ... }: {
    nixosConfigurations = {
      hostname = nixpkgs.lib.nixosSystem {
        modules = [
          ifstate.nixosModules.default
        ];
      };
    };
  };
}