Installation

Download the install ISO file over BitTorrent or directly.
Each ISO can boot into a live session, and doubles as the installation medium. Using the 64-bit ISO is recommended, as the CD-sized ISO has been surgically reduced in size.
To log in after booting into the live session, enter the username user and the password live.
See below for system requirements and further instructions.

System requirements

The following requirements apply for both 32bit and 64bit systems:

RAM (minimum) RAM (recommended) Hard Drive (recommended)
>= 1G >= 2G 20G

Depending on the applications and feature set you decide to use (especially if you do not run a graphical desktop), the system may run fine with less resources. An installation from the live ISOs uses approximately 2.1G of space on the hard drive.

Installing from a live ISO image (CD/DVD/USB key)

Download the ISO image that fits your use case from the link section at the top of the page. Installing from a live ISO image booted off of a burnt DVD/CD or USB key is the preferred and fully supported way of installing the BunsenLabs Linux distribution.

You may find help with burning the file to disk or writing to a USB key in the Debian FAQ section:

To log in after booting the live session, enter the username user and the password live.

There is a section on the forums which deals with any issues, bugs and comments related to the current release, should you find or have one.

Verifying the integrity of your download

It is highly recommended to verify the integrity of any downloaded ISO file. This ensures that the image is not corrupted, and that the image has not been altered.

There are two ways to verify the ISO file:

Using checksums

If you have downloaded the image from our SSL-secured website, you can quickly verify the integrity of the downloaded ISO file by comparing its SHA-256 checkum to the one published above.

Execute the following shell commands in the directory you’ve downloaded the ISO file(s) to:

CHECKSUMS=$(curl -Ls https://ddl.bunsenlabs.org/ddl/lithium-1.sha256sums.txt)
printf "%s\n" "$CHECKSUMS" | sha256sum -c --ignore-missing

Alternatively, download the SHA-256 checksum file manually using the links at the top of this page, and compute and compare the checksum using a tool of your choosing.

Using PGP signatures

We use our PGP release key to sign our images. Each downloaded ISO file can be verified using the key and the signature file.

Import the key into your local user’s keyring by executing

gpg --import <(curl -Ls https://ddl.bunsenlabs.org/ddl/BunsenLabs-RELEASE.asc)

Verify the signature by downloading both the ISO file and the signature file to the same directory using the links at the top of this page, and invoking GnuPG as follows

gpg --verify SIGNATURE_FILE ISO_FILE

GnuPG should tell you that the file has a ‘good’ signature.

Package-based install

You may also choose to follow our repository set-up instructions and include our package repository into your existing Debian system. This way, you can selectively install packages from the BunsenLabs project and use only a subset of our configurations and assets.

The Lithium packages are made to be installed on the latest Debian release, currently Debian 10.