Skip to content

Distributions

Bifröst is available in different distributions.

On this page you'll find:

  1. Operating Systems
    1. Linux
    2. macOS
    3. Windows
  2. Packaging
    1. Archives
    2. OCI/Docker Images
    3. Compliance Artifacts
Architecture linux darwin windows
Binary Image Binary Image Binary Image
i386 / / / / / /
amd64 / / / / / /
armv6 / / / / / /
armv7 / / / / / /
arm64 / / / / / /
riscv64 / / / / / /

Cells express support in format of <generic>/<extended>.

Operating Systems

Bifröst is currently available for Linux, macOS and Windows.

Linux

Generic

The generic Linux distribution of Bifröst requires kernel support for PR_SET_CHILD_SUBREAPER, which is available since Linux 3.4. The effective minimum kernel can be higher for newer architectures. The binary does not require other shared libraries to be installed, regardless of whether the distribution is Ubuntu, Alpine, RedHat, or another variant. On the other hand, it lacks some features of the extended version.

Extended

The extended Linux distribution of Bifröst currently only runs on Debian 12+, Ubuntu 22.04+ and Fedora 39+.

It does provide the following features:

  1. PAM authentication via Local authorization

Dependencies

Name Shared-Lib Version
GNU C Library (glibc) libc.so.6 2.34+
Linux PAM (Pluggable Authentication Modules for Linux) libpam.so.0 1.4+
Installation
  • Debian/Ubuntu: Usually installed by default, in some cases the following command might be necessary: 
    1
    sudo apt install libpam0g -y
  • RedHat/Fedora: Already installed by default.

macOS

Generic

The generic macOS distribution of Bifröst contains all supported features for macOS 13 and later. It does not have any requirements on which other shared libraries need to be installed.

Extended

Not available.

Windows

Generic

The generic Windows distribution of Bifröst contains all supported features for Windows 10, Windows Server 2016, and later versions. It does not have any requirements on which other shared libraries need to be installed.

Extended

Not available.

Packaging

Bifröst can be either obtained as Archive which contains the binaries or as OCI/Docker images.

Archives

Archives contain for every supported operating systems and architecture the binary of Bifröst itself with a basic README, licence information and demo material. It can be simply downloaded, extracted and run.

See the release page for all available downloads.

Matrix

Architecture linux darwin windows
i386 / / /
amd64 / / /
armv6 / / /
armv7 / / /
arm64 / / /
riscv64 / / /

URL Syntax

  • Linux: 
    1
    https://github.com/engity-com/bifroest/releases/download/v1.0.0-beta1/bifroest-linux-%3Carch%3E-%3Cedition%3E.tgz
  • macOS: 
    1
    https://github.com/engity-com/bifroest/releases/download/v1.0.0-beta1/bifroest-darwin-%3Carch%3E-%3Cedition%3E.tgz
  • Windows: 
    1
    https://github.com/engity-com/bifroest/releases/download/v1.0.0-beta1/bifroest-windows-%3Carch%3E-%3Cedition%3E.zip
Examples

  • Linux Extended on AMD64: 

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

  • macOS Generic on ARM64: 

    1
2
    sudo install -d /usr/local/bin
curl -sSLf https://github.com/engity-com/bifroest/releases/download/v1.0.0-beta1/bifroest-darwin-arm64-generic.tgz | sudo tar -zxv -C /usr/local/bin bifroest

  • macOS Generic on AMD64: 

    1
2
    sudo install -d /usr/local/bin
curl -sSLf https://github.com/engity-com/bifroest/releases/download/v1.0.0-beta1/bifroest-darwin-amd64-generic.tgz | sudo tar -zxv -C /usr/local/bin bifroest

  • Windows Generic on AMD64:

    Run elevated
    1
2
3
    mkdir -Force 'C:\Program Files\Engity\Bifroest'
curl -sSLf -o "${Env:Temp}\bifroest.zip" https://github.com/engity-com/bifroest/releases/download/v1.0.0-beta1/bifroest-windows-amd64-generic.zip
Expand-Archive "${Env:Temp}\bifroest.zip" -DestinationPath 'C:\Program Files\Engity\Bifroest'

OCI/Docker Images

Bifröst is also available in OCI/Docker images. You just need to mount a valid configuration into the container.

See the container registry page for all available tags.

Alpha and beta releases publish only their full version tags (for example, 1.0.0-beta1, generic-1.0.0-beta1 and extended-1.0.0-beta1). Moving tags such as latest, generic, extended, and major/minor aliases refer only to stable releases. Use the full version tag when installing a prerelease.

Matrix

Architecture linux darwin windows
i386 / / /
amd64 / / /
armv6 / / /
armv7 / / /
arm64 / / /
riscv64 / / /

TAG Syntax

  • Generic: 

    1
2
3
4
5
6
7
8
    ghcr.io/engity-com/bifroest:generic-<major>.<minor>.<patch>
ghcr.io/engity-com/bifroest:generic-<major>.<minor>
ghcr.io/engity-com/bifroest:generic-<major>
ghcr.io/engity-com/bifroest:generic
ghcr.io/engity-com/bifroest:<major>.<minor>.<patch>
ghcr.io/engity-com/bifroest:<major>.<minor>
ghcr.io/engity-com/bifroest:<major>
ghcr.io/engity-com/bifroest:latest

  • Extended: 

    1
2
3
4
    ghcr.io/engity-com/bifroest:extended-<major>.<minor>.<patch>
ghcr.io/engity-com/bifroest:extended-<major>.<minor>
ghcr.io/engity-com/bifroest:extended-<major>
ghcr.io/engity-com/bifroest:extended

Examples

On a release-specific documentation page, the first image below matches that release. The other tags select moving stable releases and do not select alpha or beta versions.

1
2
3
ghcr.io/engity-com/bifroest:1.0.0-beta1
ghcr.io/engity-com/bifroest:latest
ghcr.io/engity-com/bifroest:extended

Compliance Artifacts

Every release provides platform- and edition-specific third-party notices and SBOMs alongside its archives. Archive SBOMs describe the downloadable archive; OCI SBOMs describe the indicated platform image within the multi-platform OCI index. They are intentionally separate because their package inventories and subject digests can differ.

The generic darwin/amd64 and darwin/arm64 release variants each include their architecture-specific archive, .third-party-notices.txt file, and archive .spdx.json and .cdx.json SBOMs. They have no OCI images or OCI SBOMs.

The release manifest relates every artifact to its platform, edition, media type and SHA-256 digest. Use the checksum file to verify all downloadable release assets.

Variant Notice Archive OCI
Download SPDX CycloneDX Reference SPDX CycloneDX
darwin/amd64/generic - - -
darwin/arm64/generic - - -
linux/386/extended - - -
linux/386/generic
linux/amd64/extended
linux/amd64/generic
linux/arm64/extended
linux/arm64/generic
linux/armv6/generic
linux/armv7/extended
linux/armv7/generic
linux/riscv64/generic
windows/amd64/generic
windows/arm64/generic - - -

OCI entries link to the container package. The abbreviated digest identifies the immutable multi-platform index; the complete index and platform references are available in the release manifest.