User:Shadowless/soju

From Gentoo Wiki
Jump to:navigation Jump to:search
This article is a stub. Please help out by expanding it - how to get started.

soju is a user-friendly IRC bouncer. soju connects to upstream IRC servers on behalf of the user to provide extra functionality. soju supports many features such as multiple users, numerous IRCv3 extensions, chat history playback and detached channels. It is well-suited for both small and large deployments.[1]

Installation

USE flags

USE flags for net-irc/soju soju is a user-friendly IRC bouncer

+sqlite Add support for sqlite - embedded sql database
moderncsqlite Use moderncsqlite, a cgo-free port of SQLite
pam Add support for PAM (Pluggable Authentication Modules) - DANGEROUS to arbitrarily flip

Emerge

root #emerge --ask net-irc/soju

Configuration

Edit the config file as desired. See the soju man page for a detailed list of configuration options.

FILE /etc/soju/configExample configuration
db sqlite3 /var/lib/soju/main.db
message-store fs /var/lib/soju/logs/
listen irc+insecure://192.168.0.1:6667

Add the soju user account to the database.

root #sojudb -config /etc/soju/config create-user soju -admin

Service

OpenRC

To run the soju bouncer server, start it with OpenRC.

root #rc-service soju start

To have the soju bouncer server start on system boot, add it to the default runlevel.

root #rc-update add soju default

systemd

To run the soju bouncer server, start it with systemd.

root #systemctl start soju.service

To have the soju bouncer server start on system boot, enable it.

root #systemctl enable soju.service

External resources

  • soju client list – Instructions for setting up various IRC clients to connect to soju

References