Solanum is an IRCv3 server designed to be highly scalable. It implements IRCv3.1 and some parts of IRCv3.2. It is meant to be used with an IRCv3-capable services implementation such as Atheme or Anope https://solanum.chat/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Jess Porter 042218080e
don't subject remote users to chm_nonotice
1 week ago
.github/workflows GH Actions: Fix Oper Guide CI 7 months ago
authd Remove Windows support 5 months ago
bandb Remove Windows support 5 months ago
doc doc/features/extban.txt: document $j, $x, and $z 3 months ago
extensions don't subject remote users to chm_nonotice 1 week ago
help Add mask modifiers to LIST help 3 months ago
include just a stray colon where it wasn't meant to have :) 2 months ago
ircd channel: always send chm_hidden modes to servers 1 month ago
librb The rb_heap_block struct doesn't appear to be used anywhere 5 months ago
m4 Innovation by sed 1 year ago
modules m_list: fail on invalid parameters 3 months ago
scripts Innovation by sed 1 year ago
ssld Remove Windows support 5 months ago
tests tests: chase listener refactor changes 5 months ago
testsuite "KDX-Line active for" is now L_NETWIDE, so remove sno_globalkline 9 months ago
tools Remove Windows support 5 months ago
wsockd Remove Windows support 5 months ago
.gitignore Update .gitignore for 25d169b649 (#69) 1 year ago
.mailmap Mailmap and copyright update for Ariadne 7 months ago
CREDITS CREDITS: add mcintosh 3 months ago
LICENSE Remove more $Id tags. 5 years ago
Makefile.am Remove *.la from install/lib 1 year ago
NEWS.md wallops: require new oper:wallops right (#110) 1 year ago
README.md Fix link to doc/readme.txt 2 months ago
autogen.sh *sigh* comment these out until travis is fixed. 5 years ago
configure.ac Remove Windows support 5 months ago
shtool Remove Windows support 5 months ago

README.md

solanum Build Status

Solanum is an IRCv3 server designed to be highly scalable. It implements IRCv3.1 and some parts of IRCv3.2.

It is meant to be used with an IRCv3-capable services implementation such as Atheme or Anope.

necessary requirements

  • A supported platform
  • A working dynamic library system
  • A working lex and yacc - flex and bison should work

platforms

Solanum is developed on Linux with glibc, but is currently portable to most POSIX-compatible operating systems. However, this portability is likely to be removed unless someone is willing to maintain it. If you’d like to be that person, please let us know on IRC.

platform specific errata

These are known issues and workarounds for various platforms.

  • macOS: you must set the LIBTOOLIZE environment variable to point to glibtoolize before running autogen.sh:
   brew install libtool
   export LIBTOOLIZE="/usr/local/bin/glibtoolize"
   ./autogen.sh
  • FreeBSD: if you are compiling with ipv6 you may experience problems with ipv4 due to the way the socket code is written. To fix this you must: sysctl net.inet6.ip6.v6only=0

  • Solaris: you may have to set your PATH to include /usr/gnu/bin and /usr/gnu/sbin before /usr/bin and /usr/sbin. Solaris’s default tools don’t seem to play nicely with the configure script. When running as a 32-bit binary, it should be started as:

   ulimit -n 4095 ; LD_PRELOAD_32=/usr/lib/extendedFILE.so.1 ./solanum

building

sudo apt install build-essential pkg-config libsqlite3-dev # or equivalent for your distribution
./autogen.sh
./configure --prefix=/path/to/installation
make
make check # run tests
make install

See ./configure --help for build options.

feature specific requirements

  • For SSL/TLS client and server connections, one of:

    • OpenSSL 1.0.0 or newer (--enable-openssl)
    • LibreSSL (--enable-openssl)
    • mbedTLS (--enable-mbedtls)
    • GnuTLS (--enable-gnutls)
  • For certificate-based oper CHALLENGE, OpenSSL 1.0.0 or newer. (Using CHALLENGE is not recommended for new deployments, so if you want to use a different TLS library, feel free.)

  • For ECDHE under OpenSSL, on Solaris you will need to compile your own OpenSSL on these systems, as they have removed support for ECC/ECDHE. Alternatively, consider using another library (see above).

tips

  • To report bugs in Solanum, visit us at #solanum on Libera Chat

  • Please read doc/readme.txt to get an overview of the current documentation.

  • Read the NEWS.md file for what’s new in this release.

  • The files, /etc/services, /etc/protocols, and /etc/resolv.conf, SHOULD be readable by the user running the server in order for ircd to start with the correct settings. If these files are wrong, Solanum will try to use 127.0.0.1 for a resolver as a last-ditch effort.

git access

  • The Solanum git repository can be checked out using the following command: git clone https://github.com/solanum-ircd/solanum

  • Solanum’s git repository can be browsed over the Internet at the following address: https://github.com/solanum-ircd/solanum