• regular and timely application updates
• easy user mappings (PGID, PUID)
• custom base image with s6 overlay
• weekly base OS updates with common layers across the entire LinuxServer.io ecosystem to minimise space usage, down time and bandwidth
• regular security updates

• Blog - all the things you can do with our containers including How-To guides, opinions and much more!
• Discord - realtime support / chat with the community and the team.
• Discourse - post on our community forum.
• GitHub - view the source for all of our repositories.
• Open Collective - please consider helping us by either donating or contributing to our budget

linuxserver/thelounge

Supported Architectures

Version Tags

Application Setup

• When the application first runs, it will populate its /config

• Stop the container

• Now from the host, edit /config/config.js, wherever you've mapped it

• In most cases you want the value public: false to allow named users only

• Setting the two prefetch values to true improves usability, but uses more storage

• Once you have the configuration you want, save it and start the container again

• For each user, run the command

• docker exec -it thelounge s6-setuidgid abc thelounge add <user>

• You will be prompted to enter a password that will not be echoed.

• Saving logs to disk is the default, this consumes more space but allows scrollback.

• To log in to the application, browse to http://<hostip>:9000

• You should now be prompted for a username and password on the web interface.

• Once logged in, you can add an IRC network. Some defaults are preset for Freenode

Read-Only Operation

Usage

docker-compose (recommended, click here for more info)

---
services:
  thelounge:
    image: lscr.io/linuxserver/thelounge:latest
    container_name: thelounge
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/thelounge/config:/config
    ports:
      - 9000:9000
    restart: unless-stopped

docker cli (click here for more info)

docker run -d \
  --name=thelounge \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 9000:9000 \
  -v /path/to/thelounge/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/thelounge:latest

Parameters

Environment variables from files (Docker secrets)

-e FILE__MYVAR=/run/secrets/mysecretvariable

Umask for running applications

User / Group Identifiers

id your_user

uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

Support Info

• Shell access whilst the container is running:

```bash
docker exec -it thelounge /bin/bash
```

• To monitor the logs of the container in realtime:

```bash
docker logs -f thelounge
```

• Container version number:

```bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' thelounge
```

• Image version number:

```bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/thelounge:latest
```

Updating Info

Via Docker Compose

• Update images:

* All images:

    ```bash
    docker-compose pull
    ```

* Single image:

    ```bash
    docker-compose pull thelounge
    ```

• Update containers:

* All containers:

    ```bash
    docker-compose up -d
    ```

* Single container:

    ```bash
    docker-compose up -d thelounge
    ```

• You can also remove the old dangling images:

```bash
docker image prune
```

Via Docker Run

• Update the image:

```bash
docker pull lscr.io/linuxserver/thelounge:latest
```

• Stop the running container:

```bash
docker stop thelounge
```

• Delete the container:

```bash
docker rm thelounge
```

• Recreate a new container with the same docker run parameters as instructed above (if mapped correctly to a host folder, your /config folder and settings will be preserved)
• You can also remove the old dangling images:

```bash
docker image prune
```

Image Update Notifications - Diun (Docker Image Update Notifier)

Building locally

git clone https://github.com/linuxserver/docker-thelounge.git
cd docker-thelounge
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/thelounge:latest .

docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset