lure/README.md

3.4 KiB

LURE Logo

LURE (Linux User REpository)

Go Report Card status-badge SWH linux-user-repository-bin AUR package

LURE is a distro-agnostic build system for Linux, similar to the AUR. It is currently in beta. Most major bugs have been fixed, and most major features have been added. LURE is ready for general use, but may still break or change occasionally.

LURE is written in pure Go and has zero dependencies after building. The only things LURE requires are a command for privilege elevation such as sudo, doas, etc. as well as a supported package manager. Currently, LURE supports apt, pacman, apk, dnf, yum, and zypper. If a supported package manager exists on your system, it will be detected and used automatically.


Installation

Install script

The LURE install script will automatically download and install the appropriate LURE package on your system. To use it, simply run the following command:

curl -fsSL lure.sh/install | bash

IMPORTANT: This will download and run the script from https://lure.sh/install. Please look through any script you download from the internet (including this one) before running it.

Packages

Distro packages and binary archives are provided at the latest Gitea release: https://gitea.elara.ws/lure/lure/releases/latest

LURE is also available on the AUR as linux-user-repository-bin

Building from source

To build LURE from source, you'll need Go 1.18 or newer. Once Go is installed, clone this repo and run:

sudo make install

Why?

LURE was created because packaging software for multiple Linux distros can be difficult and error-prone, and installing those packages can be a nightmare for users unless they're available in their distro's official repositories. It automates the process of building and installing unofficial packages.


Documentation

The documentation for LURE is in the docs directory in this repo.


Web Interface

LURE has an open source web interface, licensed under the AGPLv3 (https://gitea.elara.ws/lure/lure-web), and it's available at https://lure.sh/.


Repositories

LURE's repos are git repositories that contain a directory for each package, with a lure.sh file inside. The lure.sh file tells LURE how to build the package and information about it. lure.sh scripts are similar to the AUR's PKGBUILD scripts.


Acknowledgements

Thanks to the following projects for making LURE possible: