Skip to main content
Version: v1.7

Installation Guide

You can run Hangar by using Hangar Docker Image inside the container or install Hangar binary on your system.

Hangar Docker Image

  • Run Hangar with docker:

    # Docker
    docker pull cnrancher/hangar:latest

    docker run -it -v $(pwd):/hangar cnrancher/hangar:latest
  • Run Hangar with podman:

    # Podman
    podman pull docker.io/cnrancher/hangar:latest

    podman run -it -v $(pwd):/hangar cnrancher/hangar:latest

For more information about Hangar Docker Image, see Hangar Docker Image page.

Installing on Linux

Arch Linux

You can obtain the PKGBUILD to build and install the latest Hangar binary file from the Arch Linux AUR repository.

  • Install hangar by using the yay AUR helper:

    # Build and install from the latest stable release tag.
    yay hangar

    # Build and install from the latest upstream main git branch.
    yay hangar-git
  • Or you can add the Open Build Service repository to install prebuilt hangar package.

    1. Add custom repository in /etc/pacman.conf:
      /etc/pacman.conf
      [home_StarryWang_Arch]
      SigLevel = Never
      Server = https://download.opensuse.org/repositories/home:/StarryWang/Arch/$arch
    2. Install hangar:
      sudo pacman -Sy
      sudo pacman -S hangar

openSUSE

Hangar is available on Open Build Service.

# openSUSE Tumbleweed
sudo zypper ar https://download.opensuse.org/repositories/home:StarryWang/openSUSE_Tumbleweed/home:StarryWang.repo
sudo zypper ref
sudo zypper in hangar

Building from Source

See Build Hangar to build and install Hangar on your system manually.