/thelounge-docker

🐳 Docker container for The Lounge, a self-hosted web IRC client

Primary LanguageShellMIT LicenseMIT

The Lounge

Docker container for The Lounge, modern web IRC client designed for self-hosting

WebsiteDocsDemo

#thelounge IRC channel on freenode Total pulls on Docker

Overview

  • Modern features brought to IRC. Push notifications, link previews, new message markers, and more bring IRC to the 21st century.
  • Always connected. Remains connected to IRC servers while you are offline.
  • Cross platform. It doesn't matter what OS you use, it just works wherever Node.js runs.
  • Responsive interface. The client works smoothly on every desktop, smartphone and tablet.
  • Synchronized experience. Always resume where you left off no matter what device.

To learn more about configuration, usage and features of The Lounge, take a look at the website.

Running a container

Using the example docker-compose.yml file. What is docker-compose?

$ docker-compose up --detach

or

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

Changing the port that The Lounge will be available on

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

$ docker run --detach \
		--name thelounge \
		--publish 5000:9000 \ # Change host port to listen on port 5000
		--volume ~/.thelounge:/var/opt/thelounge \
		--restart always \
		thelounge/thelounge:latest

Environment variables (advanced usage)

You can control how The Lounge is started 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)

Where is data stored?

The Lounge reads and stores its configuration, logs and other data at /var/opt/thelounge.