MirrorHub/construct
0
0
Fork 0
mirror of https://github.com/matrix-construct/construct synced 2024-06-01 01:28:54 +02:00
Code Issues Releases Wiki Activity
10800 commits 1 branch 23 tags 42 MiB
C++ 87.4%
JavaScript 4%
M4 2.4%
C 2%
Nix 1.2%
Other 3%
Go to file
Jason Volk 322a686d2f README: Tweak format / presentation. [skip ci]
2019-09-16 09:28:24 -07:00
construct construct::console: Use context::DISPATCH flag for faster response. 2019-09-15 19:36:39 -07:00
deps gitmodules: Remove riot-* from submodule list; minor cleanup. 2019-08-03 14:33:02 -07:00
doc doc: Update style. [skip ci] 2019-09-08 14:43:53 -07:00
include/ircd ircd:Ⓜ️:event::refs: Branch on the event_idx sentinel here. 2019-09-15 20:21:17 -07:00
ircd ircd:Ⓜ️:event::fetch: End catch block for context switch. 2019-09-15 20:27:55 -07:00
modules modules/client/sync/rooms/state: Employ prev_content elision on some appends. 2019-09-15 20:04:23 -07:00
share share/Makefile.am: Test DESTDIR/datadir dir 2019-01-20 11:23:34 -08:00
tools tools: Update doxygen.conf. 2019-07-29 17:08:36 -07:00
.appveyor.yml appveyor.yml: Use --enable-assert so issues in the smoketest cause failure. 2019-06-21 20:13:23 -07:00
.gitignore gitignore: Ignore any files suffixed with .tmp 2019-07-29 17:09:51 -07:00
.gitmodules gitmodules: Remove riot-* from submodule list; minor cleanup. 2019-08-03 14:33:02 -07:00
.travis.yml travis.yml: Travis-CI became useless and inept I guess at some point because 14.04 is not relevant to us. 2018-09-04 23:43:49 -07:00
autogen.sh Move m4 to tools/m4. 2018-09-17 18:52:26 -07:00
configure.ac configure: Check for ICMP support on linux platform. 2019-08-22 08:53:26 -07:00
LICENSE Update LICENSE copyright year. 2018-01-10 21:34:21 -08:00
Makefile.am Makefile: Update mrproper rules. 2018-11-14 17:05:31 -08:00
NEWS.md Update NEWS. 2017-12-12 14:59:41 -07:00
README.md README: Tweak format / presentation. [skip ci] 2019-09-16 09:28:24 -07:00

README.md

This — is The Construct

It all started in 1988 when Jarkko Oikarinen developed a free and open source server at the University of Oulu which facilitated real-time communication over the internet. Its derivatives have underpinned the major chat networks for decades ever since.

Due to their age and stagnation since the mid-2000's, a growing number of proprietary cloud services have filled the vacuum of innovation. In 2014 a new approach was proposed to reinvigorate real-time communication for free and open source software: a federation of networks known as the matrix.

This is the Construct — the community's own Matrix server. It is designed to be fast and highly scalable, and to be 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 all of the old code has been rewritten, the same spirit and philosophy of its predecessors is still obvious throughout.

Matrix is about giving you control over your communication; Construct is about giving you control over Matrix.

Installation

Chat in #test:zemos.net

Dependencies

  • Boost library 1.66+
  • RocksDB library 5.16.6.
  • Sodium library for curve ed25519.
  • OpenSSL library for HTTPS TLS / X.509.
  • Magic library for MIME type recognition.
Optional
  • zlib or lz4 or snappy database compressions.
  • GraphicsMagick for media thumbnails.
  • jemalloc for dynamic memory.
Build tools

  • GNU C++ compiler, automake, autoconf, autoconf2.13, autoconf-archive, libtool.

  • A platform capable of loading dynamic shared objects at runtime is required.

Getting Started

  1. At this phase of development the best thing to do is pull the master branch and use the latest head.

  2. See the BUILD instructions to compile Construct from source.

  3. See the SETUP instructions to run Construct for the first time.

TROUBLESHOOTING

See the TROUBLESHOOTING guide for solutions to possible problems.

Developers

Generate doxygen using /usr/bin/doxygen tools/doxygen.conf the target directory is doc/html. Browse to doc/html/index.html.

Plan

Roadmap for service

  • Phase One: Matrix clients using HTTPS.
  • Phase Two: Legacy IRC network TS6 protocol.
  • Phase Three: Legacy IRC clients using RFC1459 / RFC2812 legacy grammars.

Roadmap for deployments

The deployment mode is a macro of configuration variables which tune the daemon for how it is being used. Modes mostly affect aspects of local clients.

  • Personal: One or few users. Few default restrictions; higher log output.
  • Company: Hundreds of users. Moderate default restrictions.
  • Public: Thousands of users. Untrusting configuration defaults.

Roadmap for innovation

  • Phase Zero: Core libircd: Utils; Modules; Contexts; JSON; Database; HTTP; etc...
  • Phase One: Matrix Protocol: Core VM; Core modules; Protocol endpoints; etc...
  • Phase Two: Construct Cluster: Kademlia sharding of events; Maymounkov's erasure codes.