Wiki > The Lounge
The Lounge is a Node.js-based IRC client with a web-based graphical interface.
Installation
These instructions will use the randomly generated port number 15216. Feel free to use an available port of your choice anywhere that port is listed.
-
Create a directory for The Lounge, its config, and its data:
mkdir ~/.thelounge
-
Install The Lounge:
cd ~/.thelounge npm install thelounge
-
Start The Lounge to generate a config file, and then kill the process:
npx thelounge start --config port=15216 ^C (Hold down the Control key and press C)
If the port 15216 is unavailable, you can change it to an available port number of your choice throughout the rest of this document, or you can refresh this page to get a new randomly generated port number.
-
Edit the config file to permanently point to that port:
sed -i 's/port: 9000,/port: 15216,/' config.js
-
Generate a user account:
npx thelounge add user
-
Start The Lounge:
screen -dmS thelounge npx thelounge start
The Lounge should now be accessible at http://server.whatbox.ca:15216/. Log in with the username and password you created.
Optional: Configure The Lounge to use SSL
-
Visit your Managed Links page
-
Select the Add App button in the upper-right corner.
-
For the app name, enter thelounge or a name of your choice.
-
For the app port, enter the following: 15216
-
Select the Save button.
Automatically Restarting The Lounge
You can create a cron job that automatically restarts The Lounge when it goes down:
cd ~/.thelounge
cat > cron <<'EOF'
#!/bin/bash
cmd='npx thelounge start'
if ! pgrep --full "$cmd" --uid $USER > /dev/null
then
cd ~/.thelounge
$cmd > /dev/null 2>&1 &
fi
EOF
chmod +x cron
(crontab -l 2> /dev/null;echo "* * * * * $HOME/.thelounge/cron") | crontab -