Skip to content

Getting started

Installation

  1. Download Bifröst (see release page):

    Syntax

    1
    curl -sSLf https://github.com/engity-com/bifroest/releases/download/0.2.0/bifroest-<os>-<arch>-<edition>.tgz | sudo tar -zxv -C /usr/bin bifroest

    Matrix

    Column headers in format of <os>/<edition>.

    arch linux/generic linux/extended windows/generic windows/extended
    amd64
    arm64

    Example

    1
    curl -sSLf https://github.com/engity-com/bifroest/releases/download/0.2.0/bifroest-linux-amd64-extended.tgz | sudo tar -zxv -C /usr/bin bifroest

  2. Configure Bifröst. For example download the demo configuration and adjust it to your needs (see documentation of configuration for the documentation about it): 

    1
2
3
4
    sudo mkdir -p /etc/engity/bifroest/
sudo curl -sSLf https://raw.githubusercontent.com/engity-com/bifroest/0.2.0/contrib/configurations/sshd-dropin-replacement.yaml -o /etc/engity/bifroest/configuration.yaml
# Adjust it to your needs
sudo vi /etc/engity/bifroest/configuration.yaml

  3. Run Bifröst: 

    1
    sudo bifroest run

Autostart

...when the system starts.

systemd

To enable Bifröst to run at every server start where systemd is available, simply: 1. Download our example service configuration: 

1
sudo curl -sSLf https://raw.githubusercontent.com/engity-com/bifroest/0.2.0/contrib/systemd/bifroest.service -o /etc/systemd/system/bifroest.service
2. Reload the systemd daemon: 
1
sudo systemctl daemon-reload
3. Enable and start Bifröst: 
1
2
sudo systemctl enable bifroest.service
sudo systemctl start bifroest.service

What's next?

Read Use-Cases and the configuration documentation to see what you can do more with Bifröst.