0
0
Fork 0
mirror of https://github.com/matrix-construct/construct synced 2024-11-18 07:50:57 +01:00
No description
Find a file
2020-05-05 20:57:59 -07:00
construct Add -defaults program option to restore from broken configurations. 2020-04-24 21:58:57 -07:00
deps Upgrade to RocksDB 6.6.4. 2020-05-05 19:58:37 -07:00
doc doc: Update BUILD instructions. [ci skip] 2020-05-04 17:21:53 -07:00
include/ircd ircd::db: Interface to get the charge value of cache entry. 2020-05-05 19:58:37 -07:00
ircd ircd::ctx::posix: Wrap pthread_timedjoin_np(). 2020-05-05 20:57:59 -07:00
matrix ircd:Ⓜ️:dbs: Ensure truncation of origin component of room_joined key. 2020-05-05 19:57:32 -07:00
modules modules/federation/send: Downgrade log level for unhandled out of eval. 2020-05-05 12:04:34 -07:00
share client: Fix style issues in firefox. 2020-01-21 13:11:03 -08:00
tools Upgrade to RocksDB 6.6.4. 2020-05-05 19:58:37 -07:00
.appveyor.yml docker/appveyor: RocksDB 5.17.2; Boost 1.71; remove PPAs for 20.04 vocal fossil. 2020-04-29 10:59:31 -07:00
.envrc nix: add default.nix and envrc/shell.nix 2020-04-22 04:44:11 +01:00
.gitignore gitignore: Ignore any files suffixed with .tmp 2019-07-29 17:09:51 -07:00
.gitmodules configure: Add submodule dependency for libpbc. 2020-02-03 21:41:46 -08: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 Upgrade to RocksDB 6.6.4. 2020-05-05 19:58:37 -07:00
default.nix nix: add default.nix and envrc/shell.nix 2020-04-22 04:44:11 +01:00
Doxyfile tools: fix doxyfile 2020-04-24 04:08:04 +01:00
LICENSE Update LICENSE copyright year. 2018-01-10 21:34:21 -08:00
Makefile.am ircd: Move matrix application related to derived library. 2019-09-27 19:35:26 -07:00
NEWS.md Update NEWS. 2017-12-12 14:59:41 -07:00
README.md doc: Start an FAQ. 2020-04-28 20:18:48 -07:00
shell.nix tools: fix doxyfile 2020-04-24 04:08:04 +01:00

This — is The Construct

Chat in #test:zemos.net

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.

Matrix is about giving you control over your communication; Construct is about giving you control over Matrix. Your privacy and security matters. We encourage you to contribute new ideas and are liberal in accepting experimental features.

Installation

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, ld.gold, 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.

  4. See the TUNING guide to optimize Construct for your deployment.

TROUBLESHOOTING

See the TROUBLESHOOTING guide for solutions to possible problems.

See the FREQUENTLY ASKED QUESTIONS for answers to the most common perplexities.

Developers

DOCUMENTATION

Generate doxygen using doxygen ./Doxyfile the target directory is doc/html. Browse to doc/html/index.html.

ARCHITECTURE GUIDE

See the ARCHITECTURE summary for design choices and things to know when starting out.

DEVELOPMENT STYLE GUIDE

See the STYLE guide for an admittedly tongue-in-cheek lecture on the development approach.

Roadmap

TECHNOLOGY
  • 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.
DEPLOYMENT
Operating a Construct server which is open to public user registration is unsafe. Local users may
be able to exceed resource limitations and deny service to other users.
  • Personal: Dozens of users. Few default restrictions; higher log output.
  • Company: Hundreds of users. Moderate default restrictions.
  • Public: Thousands of users. Untrusting configuration defaults.

Due to the breadth of the Matrix client/server protocol we can only endorse production use of Construct gradually while local user restrictions are developed. This notice applies to locally registered users connecting with clients, it does not apply to federation.