Getting Started

First steps with Luet


No dependencies. For building packages see the Build Packages section

Get Luet

From release

Just grab a release from the release page on GitHub. The binaries are statically compiled.

Or you can install Luet also with a single command:

curl | sudo sh

Building Luet from source


  • Golang installed in your system.
  • make
$> git clone
$> cd luet
$> make build # or just go build

Install it as a system package

In the following section we will see how to install luet with luet itself. We will use a transient luet version that we are going to throw away right after we install it in the system.

# Get a luet release. It will be used to install luet in your system
wget -O luet
chmod +x luet

# Creates the luet configuration file and add the luet-index repository.
# The luet-index repository contains a collection of repositories which are 
# installable and tracked in your system as standard packages.
cat > .luet.yaml <<EOF
- name: "mocaccino-repository-index"
  description: "MocaccinoOS Repository index"
  type: "http"
  enable: true
  cached: true
  priority: 1
  - ""

# Install the official luet repository to get always the latest luet version
./luet install repository/luet

# Install luet (with luet) in your system
./luet install system/luet

# Remove the temporary luet used for bootstrapping
rm -rf luet

# Copy over the config file to your system
mkdir -p /etc/luet
mv .luet.yaml /etc/luet/luet.yaml


Luet stores its configuration files in /etc/luet. If you wish to override its default settings, create a file /etc/luet/luet.yaml.

An example of a configuration file can be found here.

There are a bunch of configuration settings available, but the most relevant are:

  color: true # Enable/Disable colored output
  enable_emoji: true # Enable/Disable emoji from output
  debug: false # Enable/Disable debug
  rootfs: "/" # What's our rootfs. Luet can install packages outside of "/"
  database_path: "/var/db/luet" # Where to store DB files
  database_engine: "boltdb"
  tmpdir_base: "/var/tmp/luet" # The temporary directory to be used

To learn more about how to configure luet, see the configuration section

Last modified August 21, 2023: Try to fix tests due to upx (#343) (c47bf48)