jtbouse/thelounge repository overview

⁠The Lounge - a self-hosted modern web IRC client

⁠Overview

This project is taken in part from the official⁠ Docker build with some modifications.

• Use the latest Alpine Node⁠ container as a base
• Upgrade Alpine before installing The Lounge

⁠Running a container

A container can be started manually:

$ docker run --detach \
              --name thelounge \
              --publish 9000:9000 \
              --volume ~/.thelounge:/var/opt/thelounge \
              --restart always \
              jtbouse/thelounge:latest

⁠Data persistence

The Lounge reads and stores all its configuration, logs and other data to THELOUNGE_HOME which is defaulted to /var/opt/thelounge in the container.

You will probably want to persist the data at this location by using one of the means⁠ to do so.

⁠Adding users

If you're not running The Lounge in public mode, you can add users as follows:

$ docker exec -it <container name> thelounge add <username>

Note: without peristing data⁠, any added users will be lost when the container is removed.

⁠Changing the port that The Lounge will be available on

To change the port on which The Lounge will be available on, you will have to change the host port mapping. To make The Lounge available on e.g. port 5000:

$ docker run --detach \
              --name thelounge \
              --publish 5000:9000 \
              --volume ~/.thelounge:/var/opt/thelounge \
              --restart always \
              jtbouse/thelounge:latest

⁠Environment variables (advanced usage)

You can control how The Lounge is started inside the container through the following environment variables:

• HOST (equivalent to the -H, --host CLI option)
• PORT (equivalent to the -P, --port CLI option)
• BIND (equivalent to the -B, --bind CLI option)