construct/doc/SETUP.md

SETUP

• For standalone builds you will need to add the included lib directories in your git repo to the library path: export LD_LIBRARY_PATH=/path/to/src/deps/boost/lib:$LD_LIBRARY_PATH export LD_LIBRARY_PATH=/path/to/src/deps/rocksdb:$LD_LIBRARY_PATH

• We will refer to your server as host.tld. For those familiar with matrix: this is your origin and mxid @user:host.tld hostpart. If you delegate your server's location to something like matrix.host.tld:1234 we refer to this as your servername.

Construct clusters all share the same origin but each individual instance of the daemon has a unique servername.

PROCEDURE

1. Execute

   There are two arguments: <origin> [servername]. If the servername argument is missing, the origin will be used for it instead.

   bin/construct host.tld
   

   There is no configuration file.

   Log messages will appear in terminal concluding with notice IRCd RUN.

2. Strike ctrl-c on keyboard

   The command-line console will appear.

3. Create a general listener socket by entering the following command:

   net listen matrix * 8448 privkey.pem cert.pem chain.pem
   

   • matrix is your name for this listener; you can use any name.
   • * and 8448 is the local address and port to bind.
   • privkey.pem and cert.pem and chain.pem are paths (ideally absolute paths) to PEM-format files for the listener's TLS.

   The Matrix Federation Tester should now pass. Browse to https://matrix.org/federationtester/api/report?server_name=host.tld and verify "AllChecksOK": true

4. To use a web-based client like Riot, configure the "webroot" directory to point at Riot's webapp/ directory by entering the following:

   conf set ircd.index.path /path/to/riot-web/webapp/
   mod reload index
   

5. Browse to https://host.tld:8448/ and register a user.