/thelounge-deb

📦 Debian/Ubuntu package for The Lounge

Primary LanguageShellMIT LicenseMIT

Debian/Ubuntu package for The Lounge

Travis CI Build Status

This repository holds out the build scripts that generates our .deb precompiled packages and also tracks Debian-specific issues in relation to the packaging.

Building and installing the package

If you are looking to simply install The Lounge, please use our pre-compiled binary .deb files available in the releases section of the main project. This section assumes you want to build a Debian package from sources.

# Clone the repository
git clone https://github.com/thelounge/thelounge-deb.git
cd thelounge-deb

# Call the build script
./build-package

After this, you should have a nice .deb file in the deb/ output folder! This file can then be installed:

# dpkg -i deb/*.deb

Configuration

The default system-wide documentation file is located at /etc/thelounge/config.js. Please note that user profiles and their IRC passwords are also stored there, so the directory is only readable by the thelounge user.

Running

The Lounge provides both a system-wide and per-user systemd unit. If you installed the package, The Lounge should already be running and accessible on http://127.0.0.1:9000.

System

Simply enable the thelounge.service unit, and your server should be up and running:

systemctl enable --now thelounge.service

User

If you do not want to run the software system-wide, or host multiple users that wish to host their own instance of The Lounge, it can also be launched per user:

systemctl --user enable --now thelounge.service

Please note that for The Lounge to start on boot in this scenario, you will also require to have lingering enabled for this user:

loginctl enable-linger $username