A user-friendly IRC bouncer https://soju.im
  • Go 99.5%
  • Makefile 0.3%
  • Shell 0.2%
Find a file
Image Calvin Lee b92cf71060
All checks were successful
builds.sr.ht Job completed
fix identd
2026-03-10 16:11:20 +00:00
auth auth/oauth2: pass downstream remote address in Forwarded header 2025-09-11 16:32:22 +02:00
cmd fix identd 2026-03-10 16:11:20 +00:00
config config: introduce shared BasicServer struct 2026-02-20 20:14:11 +01:00
contrib Update convoyeur repo url 2026-02-05 18:35:19 +01:00
database database: introduce ErrDuplicateDeviceCertificate 2026-02-20 09:19:05 +01:00
doc Introduce the soju.im/client-cert IRC extension 2026-02-20 09:19:11 +01: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 conn: fix panic when tls.ConnectionState is nil for WebSockets 2026-02-22 14:33:51 +01:00
downstream.go server: replace Config.MsgStore{Driver,Path} with MsgStore type 2026-02-20 20:10:45 +01:00
go.mod Upgrade dependencies 2026-02-20 13:07:42 +01:00
go.sum Upgrade dependencies 2026-02-20 13:07:42 +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 config: introduce shared BasicServer struct 2026-02-20 20:14:11 +01:00
server_test.go server: replace Config.MsgStore{Driver,Path} with MsgStore type 2026-02-20 20:10:45 +01:00
service.go database: introduce ErrDuplicateDeviceCertificate 2026-02-20 09:19:05 +01:00
service_test.go Hand-made word splitter for BouncerServ 2021-06-24 19:33:46 +02:00
upstream.go upstream: fix negated ISUPPORT handling 2026-02-22 19:56:48 +01:00
user.go server: replace Config.MsgStore{Driver,Path} with MsgStore type 2026-02-20 20:10:45 +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