2017-10-16 06:12:18 +02:00
|
|
|
# IRCd<sup><img src="http://www.iconj.com/ico/p/s/ps5wyionii.ico" /></sup>
|
2015-02-25 03:32:08 +01:00
|
|
|
|
2017-10-16 06:12:18 +02:00
|
|
|
<img align="right" src="https://i.imgur.com/mHGxDyC.png" />
|
|
|
|
|
|
|
|
### Internet Relay Chat daemon: *Charybdis*
|
2016-01-23 20:52:57 +01:00
|
|
|
|
2017-08-18 00:33:22 +02:00
|
|
|
IRCd is a free and open source server which facilitates real-time communication over the
|
2017-10-25 18:24:50 +02:00
|
|
|
internet. It was started in 1988 by Jarkko Oikarinen at the University of Oulu and [its
|
|
|
|
derivatives](https://upload.wikimedia.org/wikipedia/commons/d/d8/IRCd_software_implementations.png)
|
|
|
|
underpinned the major IRC networks for decades. Eventually the project found itself
|
|
|
|
under the curation of William Pitcock et al, whom after 2005 further developed it under
|
|
|
|
the brand *Charybdis*.
|
2017-09-09 14:50:16 +02:00
|
|
|
|
2017-10-25 18:24:50 +02:00
|
|
|
In 2014 a new approach was proposed to reinvigorate real-time communication in lieu of growing
|
|
|
|
proprietary competition from opaque cloud services. This is known as the
|
|
|
|
[*Matrix Protocol*](https://matrix.org/docs/spec/): a superset of IRC that evolves it into a federation
|
|
|
|
of networks and provides a means for interoperability with the modern 21st century internet messaging
|
|
|
|
ecosystem.
|
2017-08-18 00:33:22 +02:00
|
|
|
|
2017-10-25 18:24:50 +02:00
|
|
|
**IRCd has been rewritten to implement the _Matrix Protocol_** using some of the latest techniques
|
|
|
|
available for modern C++ free software. Just like the first iteration of IRCd, the latest Charybdis
|
|
|
|
employs technologies in vogue for this era which provide a fulfilling experience for users and a
|
|
|
|
powerfully extensible environment for developers.
|
2017-08-18 00:33:22 +02:00
|
|
|
|
2017-10-25 18:24:50 +02:00
|
|
|
### Charybdis/5
|
2017-08-18 00:33:22 +02:00
|
|
|
|
2017-09-26 23:10:02 +02:00
|
|
|
Charybdis is designed to be fast and highly scalable, and to be community
|
2017-10-25 18:24:50 +02:00
|
|
|
developed by volunteer contributors over the internet. This mission strives to make
|
|
|
|
the software easy to understand, modify, audit, and extend. It remains true to its
|
|
|
|
roots with its modular design and having minimal requirements. Even though almost all
|
|
|
|
of the old code has been rewritten, the same spirit and _philosophy of the
|
|
|
|
predecessor_ is still obvious throughout.
|
|
|
|
|
|
|
|
This is the first implementation of a Matrix homeserver written in C++. It serves
|
|
|
|
matrix clients over HTTP. Additionally the RFC1459 family of legacy grammars are
|
|
|
|
employed to translate matrix to and from legacy IRC networks supporting TS6.
|
2017-09-26 23:10:02 +02:00
|
|
|
|
2017-10-25 18:24:50 +02:00
|
|
|
#### Link charybdis/4 to charybdis/5 to federate your IRC network clients.
|
2017-09-26 23:10:02 +02:00
|
|
|
|
|
|
|
|
|
|
|
## Installation
|
2017-08-18 00:33:22 +02:00
|
|
|
|
2017-10-25 18:24:50 +02:00
|
|
|
Getting up and running with Charybdis is easy. A deployment can scale from as little as
|
|
|
|
a low-end virtual machine running a stock linux distribution to a large load balanced
|
|
|
|
cluster operating in synchrony.
|
|
|
|
|
2017-08-18 00:33:22 +02:00
|
|
|
|
2017-09-26 23:10:02 +02:00
|
|
|
#### Dependencies
|
2017-08-18 00:33:22 +02:00
|
|
|
|
2017-09-23 07:19:47 +02:00
|
|
|
**Boost** (1.61 or later) - We have replaced libratbox with the well known and actively
|
|
|
|
developed Boost libraries. These are included as a submodule in this repository.
|
2017-08-18 00:33:22 +02:00
|
|
|
|
2017-09-23 07:19:47 +02:00
|
|
|
**RocksDB** (based on LevelDB) - We replace sqlite3 with a lightweight and embedded database
|
|
|
|
and have furthered the mission of eliminating the need for external "IRC services"
|
2017-08-18 00:33:22 +02:00
|
|
|
|
2017-10-01 04:14:45 +02:00
|
|
|
*Other dependencies:* **sodium** (NaCl crypto), **OpenSSL**, **zlib**, **snappy** (for rocksdb)
|
|
|
|
|
2017-09-23 07:19:47 +02:00
|
|
|
*Build dependencies:* **gnu++14 compiler**, **automake**, **autoconf**, **autoconf2.13**,
|
|
|
|
**autoconf-archive**, **libtool**, **shtool**
|
|
|
|
|
2017-08-18 00:33:22 +02:00
|
|
|
|
2017-09-09 14:50:16 +02:00
|
|
|
#### Downloading Charybdis
|
2015-02-25 03:32:08 +01:00
|
|
|
|
2017-09-23 07:19:47 +02:00
|
|
|
`git clone https://github.com/charybdis-ircd/charybdis`
|
|
|
|
`cd charybdis`
|
|
|
|
`git checkout 5`
|
|
|
|
- Verify you have the latest source tree and **are on the Matrix branch**.
|
|
|
|
|
2017-08-18 00:33:22 +02:00
|
|
|
|
2017-09-26 23:10:02 +02:00
|
|
|
### Building from git (production)
|
2017-09-09 14:50:16 +02:00
|
|
|
|
2017-09-23 07:19:47 +02:00
|
|
|
`./autogen.sh`
|
|
|
|
`./configure`
|
|
|
|
`make`
|
|
|
|
`sudo make install`
|
|
|
|
|
2017-09-09 14:50:16 +02:00
|
|
|
|
|
|
|
#### Building from git (DEVELOPER PREVIEW INSTRUCTIONS)
|
|
|
|
|
2017-09-26 23:10:02 +02:00
|
|
|
*This is only intended to allow development with dependencies that have not made
|
|
|
|
their way to mainstream systems yet.* **Not for release.**
|
|
|
|
|
2017-09-23 07:19:47 +02:00
|
|
|
The developer preview will install charybdis in a specific directory isolated from the
|
2017-09-26 23:10:02 +02:00
|
|
|
system. It will avoid using system libraries by downloading and building the dependencies
|
|
|
|
from the submodules we have pinned here and build them the way we have configured. You may
|
|
|
|
need to set the `LD_LIBRARY_PATH` to the built libraries and/or maintain an intact build
|
|
|
|
directory.
|
2017-09-23 07:19:47 +02:00
|
|
|
|
|
|
|
`./autogen.sh`
|
|
|
|
`mkdir build`
|
|
|
|
- The install directory may be this or another place of your choosing.
|
|
|
|
- If you decide elsewhere, make sure to change the `--prefix` in the `./configure`
|
|
|
|
statement below.
|
|
|
|
|
|
|
|
`CXX=g++-6 ./configure --prefix=$PWD/build --enable-debug --with-included-boost=shared --with-included-rocksdb=shared`
|
|
|
|
- Many systems alias `g++` to an older version. To be safe, specify a version manually
|
|
|
|
in `CXX`. This will also build the submodule dependencies with that version.
|
|
|
|
- The `--with-included-*` will fetch, configure **and build** the dependencies included
|
|
|
|
as submodules. Include `=shared` for now until static libraries are better handled.
|
|
|
|
|
|
|
|
`make`
|
|
|
|
`make install`
|
2015-02-25 03:32:08 +01:00
|
|
|
|
2016-03-23 21:10:44 +01:00
|
|
|
|
2017-09-09 14:50:16 +02:00
|
|
|
### Platforms
|
2015-02-25 03:32:08 +01:00
|
|
|
|
2016-07-24 00:42:04 +02:00
|
|
|
[![Charybdis](http://img.shields.io/SemVer/v5.0.0-dev.png)](https://github.com/charybdis-ircd/charybdis/tree/master)
|
|
|
|
*This branch is not meant for production. Use at your own risk.*
|
2016-03-06 00:49:13 +01:00
|
|
|
|
2016-07-24 00:42:04 +02:00
|
|
|
| <sub> Continuously Integrated Host </sub> | <sub> Compiler </sub> | <sub> Third party </sub> | <sub> Status </sub> |
|
|
|
|
|:------------------------------------------- |:------------------------ |:------------------------ |:------------------- |
|
2017-09-09 14:50:16 +02:00
|
|
|
| <sub> Linux Ubuntu 16.04 Xenial </sub> | <sub> GCC 6 </sub> | <sub> Boost 1.62 </sub> | [![POSIX Build Status](https://travis-ci.org/charybdis-ircd/charybdis.svg?branch=master)](https://travis-ci.org/charybdis-ircd/charybdis) |
|
|
|
|
| <sub> Linux Ubuntu 14.04 Xenial </sub> | <sub> Clang 3.8 </sub> | <sub> Boost 1.62 </sub> | [![POSIX Build Status](https://travis-ci.org/charybdis-ircd/charybdis.svg?branch=master)](https://travis-ci.org/charybdis-ircd/charybdis) |
|
|
|
|
| <sub> Apple Darwin 15.5 </sub> | <sub> LLVM 7.3.0 </sub> | <sub> Boost 1.62 </sub> | [![POSIX Build Status](https://travis-ci.org/charybdis-ircd/charybdis.svg?branch=master)](https://travis-ci.org/charybdis-ircd/charybdis) |
|
|
|
|
| <sub> Windows </sub> | <sub> mingw 3.5 </sub> | <sub> Boost 1.62 </sub> | [![Windows Build Status](https://ci.appveyor.com/api/projects/status/is0obsml8xyq2qk7/branch/master?svg=true)](https://ci.appveyor.com/project/kaniini/charybdis/branch/master) |
|
2016-03-06 00:49:13 +01:00
|
|
|
|
2017-03-31 00:57:58 +02:00
|
|
|
## Tips
|
2015-02-25 03:32:08 +01:00
|
|
|
|
|
|
|
* Please read doc/index.txt to get an overview of the current documentation.
|
|
|
|
|
2016-03-23 21:10:44 +01:00
|
|
|
* Read the NEWS file for what's new in this release.
|
|
|
|
|
2017-08-23 23:45:41 +02:00
|
|
|
## Developers
|
|
|
|
|
2017-09-12 18:37:44 +02:00
|
|
|
* Generate doxygen using `/usr/bin/doxygen tools/doxygen.conf` the target
|
|
|
|
directory is doc/html. Browse to doc/html/index.html
|