Skip to content

Install

Jump to bottom
McDope edited this page May 24, 2022 · 19 revisions

Install

It's recommended to install by using either the Debian or Fedora package, depending on your Distribution.

By doing so you get the usual benefits of apt/rpm and can easily uninstall later.

For Debian you also get a working config out-of-box if you have connected the USB-Device you want to use before installing. It will integrate the PAM module into your current PAM setup by utilizing pam-auth-update from libpam-runtime. Though this only allows you to configure a single user. If you want to configure additional users run pamusb-conf --add-user=<username> after installing.

For Fedora you will have to manually configure pamusb since there is nothing like debconf in rpm.

Installing from source

Requirements for compiling from source (Debian based)

Before proceeding, make sure all dependencies are installed:

  • libxml2-dev
  • libpam0g-dev
  • libudisks2-dev
  • libglib2.0-dev
  • gir1.2-udisks-2.0
  • python3
  • python3-gi

... for copy 'n paste comfort: sudo apt install libxml2-dev libpam0g-dev libudisks2-dev libglib2.0-dev gir1.2-udisks-2.0 python3 python3-gi

Requirements for compiling from source (Fedora based)

  • libxml2-devel
  • pam-devel
  • libudisks2-devel
  • glib2-devel
  • python3-gobject

... for copy 'n paste comfort: sudo dnf install libxml2-devel pam-devel libudisks2-devel glib2-devel python3-gobject

Compiling from source

$ make
# sudo make install

When compiling from source you won't get the auto-config of the debian package. See Getting started or Configuration to configure your setup.

Create a package

Packaging is done in Docker containers so will have to set that up first. Also make sure your user is allowed to start containers without root privileges. See other sources for how to do this - it would be too much for this Wiki.

Create .deb

Run make build-debian. Afterwards you will find the created deb package in the .build directory.

This requires only Docker since everything will be done in the container.

Create .rpm

Run make build-fedora. Afterwards you will find the created rpm package in the .build directory.

This requires only Docker since everything will be done in the container.

Installing from repository

There is an APT repository with prebuilt deb packages available. You can find it at https://apt.mcdope.org/.

Arch users will need to compile from source since the AUR package is outdated.

Fedora users need to build their own RPM. I won't provide a repository since I couldn't properly test it myself since I use only deb based distributions.

Clone this wiki locally