A user-friendly IRC bouncer https://soju.im
Find a file
Simon Ser 84ca9cf640
All checks were successful
builds.sr.ht Job completed
Upgrade dependencies
2025-12-20 15:17:49 +01:00
auth auth/oauth2: pass downstream remote address in Forwarded header 2025-09-11 16:32:22 +02:00
cmd Add http+insecure+prometheus listener combination 2025-12-03 08:04:44 +00:00
config Add icon directive to config file 2025-11-08 00:23:58 +01:00
contrib contrib/clients: switch Halloy URLs to new domain name 2025-11-13 23:44:10 +01:00
database database/postgres: Fix error on message with invalid UTF-8 2025-12-04 22:38:05 +01:00
doc Add http+insecure+prometheus listener combination 2025-12-03 08:04:44 +00:00
fileupload Fix file upload on connections with explicit network/device 2025-09-19 13:35:43 +02:00
identd identd: use UNKNOWN for OS name 2023-02-23 13:27:25 +01:00
msgstore msgstore: fully plumb context 2025-07-24 19:34:29 +02:00
xirc upstream: decode ISUPPORT values 2025-11-02 21:30:59 +01:00
.build.yml Migrate to Codeberg 2024-07-04 21:28:11 +02:00
.editorconfig Add .editorconfig 2020-11-30 11:39:41 +01:00
.gitignore gitignore: add doc/sojuctl.1 2023-04-05 10:56:36 +02:00
certfp.go Split CertFP logic into separate file 2021-10-08 09:47:25 +02:00
config.in Switch message-store to db in default config file 2025-05-13 13:05:03 +02:00
conn.go Support authenticating with SASL EXTERNAL 2025-11-18 08:56:54 +01:00
downstream.go Support authenticating with SASL EXTERNAL 2025-11-18 08:56:54 +01:00
go.mod Upgrade dependencies 2025-12-20 15:17:49 +01:00
go.sum Upgrade dependencies 2025-12-20 15:17:49 +01:00
irc.go Migrate to Codeberg 2024-07-04 21:28:11 +02:00
irc_test.go Ignore highlights in URLs 2024-03-01 11:33:01 +01:00
LICENSE Switch license to AGPLv3 2020-02-07 17:41:51 +01:00
Makefile pam: change service name to soju and install etc/pam.d/soju 2025-04-04 09:03:44 -04:00
rate.go Add exponential backoff when re-connecting to upstream 2021-12-02 12:14:35 +01:00
README.md readme: link to contrib/README.md 2025-06-09 15:28:41 +02:00
server.go Add icon directive to config file 2025-11-08 00:23:58 +01:00
server_test.go service: add server debug 2024-11-22 18:40:06 +01:00
service.go Support authenticating with SASL EXTERNAL 2025-11-18 08:56:54 +01:00
service_test.go Hand-made word splitter for BouncerServ 2021-06-24 19:33:46 +02:00
upstream.go Fix stripping batch tags off forwarded upstream messages 2025-11-20 16:36:47 +01:00
user.go user: also delay channel joining when authenticating via certificate 2025-11-12 22:01:49 +01:00

soju

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.

Usage

Building and installing

Dependencies:

  • Go
  • BSD or GNU make
  • a C89 compiler (optional, for SQLite)
  • scdoc (optional, for man pages)

For end users, a Makefile is provided:

make
sudo make install

For development, you can use go run ./cmd/soju as usual. See the development setup page.

To link with the system libsqlite3, set GOFLAGS="-tags=libsqlite3". To disable SQLite support, set GOFLAGS="-tags=nosqlite". To use an alternative SQLite library that does not require CGO, set GOFLAGS="-tags=moderncsqlite". To build with PAM authentication support, set GOFLAGS="-tags=pam".

Contributing

Send patches on Codeberg or on GitHub, report bugs on the issue tracker. Discuss in #soju on Libera Chat.

License

AGPLv3, see LICENSE.

Copyright (C) 2020 The soju Contributors