Telodendria - Revision history

Array in a Matrix: 10 revisions imported: Import original IM Wiki

2024-07-14T03:24:13Z

10 revisions imported: Import original IM Wiki

← Older revision		Revision as of 03:24, 14 July 2024
(No difference)

Matrix>LDA: start adminwerk

2024-01-20T12:24:59Z

start adminwerk

← Older revision		Revision as of 12:24, 20 January 2024
Line 9:		Line 9:

	=== Modifying the configuration ===		=== Modifying the configuration ===
	{{Note\|~~This~~ is ~~essentially a boiled-down version of~~ Telodendria's wiki page on [https://git.telodendria.io/Telodendria/Telodendria/src/branch/master/docs/user/config.md configuration]}}		{{Note\|More information is available at Telodendria's wiki page on [https://git.telodendria.io/Telodendria/Telodendria/src/branch/master/docs/user/config.md configuration]}}
	The configuration is stored in a JSON file called <code>[dir]/config.json</code>, which contains the following properties:		The configuration is stored in a JSON file called <code>[dir]/config.json</code>, which contains the following properties:
	* <code>listen</code>: A required object list (Telodendria supports multiple listeners) storing ''where'' Telodendria should listen for requests:		* <code>listen</code>: A required object list (Telodendria supports multiple listeners) storing ''where'' Telodendria should listen for requests:
Line 67:		Line 67:
	</syntaxhighlight>		</syntaxhighlight>
	It should log <code>No database directory specified.</code> before shutting down.		It should log <code>No database directory specified.</code> before shutting down.

			== Administration API ==
			{{Note\|More information is available at Telodendria's wiki page on [https://git.telodendria.io/Telodendria/Telodendria/src/branch/master/docs/user/admin its admin API]}}
			Telodendria uses a custom admin API, accessible from <code>/_telodendria/admin/v1</code> (note that endpoints here will use this as a base, so <code>/_telodendria/admin/v1/foo</code> will just be <code>/foo</code>). Unlike [[Synapse]], there are multiple "privileges", allowing fine-grained control over what admins can do<ref name="privileges">https://git.telodendria.io/Telodendria/Telodendria/src/branch/master/docs/user/admin/privileges.md</ref>:
			* <code>DEACTIVATE</code>: Allows an user to deactivate other users with '''POST''' <code>/deactivate/[local]</code>
			* <code>ISSUE_TOKENS</code>: Allows an user to issue registration tokens to other users (which can be used to give users specific privileges).
			* <code>GRANT_PRIVILEGES</code>: Allows an user to change other users' privileges with '''GET\|POST\|PUT\|DELETE''' <code>/privileges/[local]</code><ref name="privileges"/>.
			* <code>CONFIG</code>: Allows an user to change Telodendria's configuration without touching the database directly with '''GET\|POST\|PUT''' <code>/config</code>.
			* <code>ALIAS</code>: Allows an user to manage the server's room aliases.
			* <code>PROC_CONTROL</code>: Allows an user to manage Telodendria's process (by "soft-restarting" or stopping it) and view statistics.
			* <code>ALL</code>: Allows an user to do ''any'' admin actions, which is equivalent to giving a user admin access in Synapse.
	== References ==		== References ==
	<references />		<references />

Matrix>Ari: add abbriviation

2024-01-19T17:28:09Z

add abbriviation

← Older revision		Revision as of 17:28, 19 January 2024
Line 1:		Line 1:
	[[Category:Server software]]		[[Category:Server software]]
	'''[https://telodendria.io Telodendria]''' is a Matrix [[Homeserver\|homeserver]] in alpha written in C99 (previously C89)<ref>Cytoplasm, which Telodendria depends on [https://git.telodendria.io/Telodendria/Cytoplasm/issues/28 has switched to using C99 features]</ref>, that aims to extremely powerful yet lightweight, while all being as POSIX-compliant as possible.		'''[https://telodendria.io Telodendria]''' (also known as '''Telo''') is a Matrix [[Homeserver\|homeserver]] in alpha written in C99 (previously C89)<ref>Cytoplasm, which Telodendria depends on [https://git.telodendria.io/Telodendria/Cytoplasm/issues/28 has switched to using C99 features]</ref>, that aims to extremely powerful yet lightweight, while all being as POSIX-compliant as possible.

	Telodendria is still in heavy development and isn't excepting a non-federating release until January 2025<ref>[https://git.telodendria.io/Telodendria/Telodendria Telodendria README]</ref>.		Telodendria is still in heavy development and isn't excepting a non-federating release until January 2025<ref>[https://git.telodendria.io/Telodendria/Telodendria Telodendria README]</ref>.

Matrix>Sininenkissa: Add page to Category:Server software

2024-01-16T21:43:26Z

Add page to Category:Server software

← Older revision		Revision as of 21:43, 16 January 2024
Line 1:		Line 1:
			[[Category:Server software]]
	'''[https://telodendria.io Telodendria]''' is a Matrix [[Homeserver\|homeserver]] in alpha written in C99 (previously C89)<ref>Cytoplasm, which Telodendria depends on [https://git.telodendria.io/Telodendria/Cytoplasm/issues/28 has switched to using C99 features]</ref>, that aims to extremely powerful yet lightweight, while all being as POSIX-compliant as possible.		'''[https://telodendria.io Telodendria]''' is a Matrix [[Homeserver\|homeserver]] in alpha written in C99 (previously C89)<ref>Cytoplasm, which Telodendria depends on [https://git.telodendria.io/Telodendria/Cytoplasm/issues/28 has switched to using C99 features]</ref>, that aims to extremely powerful yet lightweight, while all being as POSIX-compliant as possible.

Matrix>Wanderer: Fixed spacing with parentheses

2024-01-16T19:01:50Z

Fixed spacing with parentheses

Matrix>LDA: explain telodendria config lore

2024-01-16T18:39:04Z

explain telodendria config lore

← Older revision		Revision as of 18:39, 16 January 2024
Line 2:		Line 2:

	Telodendria is still in heavy development and isn't excepting a non-federating release until January 2025<ref>[https://git.telodendria.io/Telodendria/Telodendria Telodendria README]</ref>.		Telodendria is still in heavy development and isn't excepting a non-federating release until January 2025<ref>[https://git.telodendria.io/Telodendria/Telodendria Telodendria README]</ref>.

			== Configuring Telodendria ==
			Telodendria essentially uses the filesystem as a database, and as such, you need to point it to an existing directory with the <code>-d [dir]</code> flag, like <code>telodendria -d data</code>.
			From that directory, several things are stored, including the actual data Telodendria has to save in order to act as a Matrix homeserver, log files, and the configuration, as <code>[dir]/config.json</code>.

			=== Modifying the configuration ===
			{{Note\|This is essentially a boiled-down version of Telodendria's wiki page on [https://git.telodendria.io/Telodendria/Telodendria/src/branch/master/docs/user/config.md configuration]}}
			The configuration is stored in a JSON file called <code>[dir]/config.json</code>, which contains the following properties:
			* <code>listen</code>: A required object list (Telodendria supports multiple listeners) storing ''where'' Telodendria should listen for requests:
			** <code>port</code>: A required integer(between 1 and 65535) representing what port Telodendria listens to.
			** <code>maxConnections</code>: An optional integer, defining the maximal amount of connections the listener should accept, which is 32 by default. You should play around, and see what values work the best for your loads.
			** <code>threads</code>: An optional integer, defining the amount of threads the listener sets up, which is 4 by default. You should play around, and see what values work the best for your loads.
			** <code>tls</code>: An optional object, containing both <code>cert</code> and <code>key</code>, which are both required paths to your certificate and key, in the format excepted by your TLS library.
			* <code>log</code>: A required object storing how Telodendria should log:
			** <code>output</code>: An enum, storing where Telodendria should log:
			*** <code>"stdout"</code>: Write to the standard output.
			*** <code>"syslog"</code>: Write to the system logger.
			*** <code>"file"</code>: Write to the <code>[dir]/telodendria.log</code> file.
			** <code>level</code>: An enum, storing the minimum level of severity for Telodendria to log an event:
			*** <code>"message"</code>
			*** <code>"debug"</code>
			*** <code>"notice"</code>
			*** <code>"warning"</code>
			*** <code>"error"</code>
			** <code>timestampFormat</code>: Represents the format Telodendria uses to write time information(see <code>strftime</code> for more).
			** <code>color</code>: A boolean, determining whenever color should be enabled, whenever possible(if on an ANSI terminal)
			* <code>runAs</code>: An object, that determines what user(<code>uid</code> as username) and role(<code>gid</code> as rolename) to run as if running as UID 0 (<code>root</code> in most systems)

			* <code>serverName</code>: A required string, representing the server's name to the federation (see [[Delegation]])
			* <code>baseUrl</code>: The URL used to prefix Matrix requests, when delegated
			* <code>pid</code>: An optional PID file Telodendria creates and writes it's PID to when running.
			* <code>federation</code>: A required boolean, used to determing whenever the server handles federation.
			* <code>registration</code>: A required boolean, used to determing whenever the server supports open registration. Please note registration tokens do bypass this.
			* <code>maxCache</code>: An optional integer, denoting how much cache to setup for the database in bytes, set to 0 by default.
			* <code>identityServer</code>: An optional [[Identity server\|identity server]] to advertise.

	== Compiling Telodendria from Git ==		== Compiling Telodendria from Git ==

Matrix>LDA: Add install "instructions" (i suck at this lol)

2024-01-16T17:47:06Z

Add install "instructions" (i suck at this lol)

@@ Line 1: / Line 1: @@
-'''[https://telodendria.io Telodendria]''' is a Matrix [[Homeserver|homeserver]] implementation currently in alpha, written in C99 (previously C89)<ref>Cytoplasm, which Telodendria depends on [https://git.telodendria.io/Telodendria/Cytoplasm/issues/28 has switched to using C99 features]</ref>, that aims to be extremely powerful yet lightweight, while being as POSIX-compliant as possible.
+'''[https://telodendria.io Telodendria]''' is a Matrix [[Homeserver|homeserver]] in alpha written in C99(previously C89)<ref>Cytoplasm, which Telodendria depends on [https://git.telodendria.io/Telodendria/Cytoplasm/issues/28 has switched to using C99 features]</ref>, that aims to extremely powerful yet lightweight, while all being as POSIX-compliant as possible.
 Telodendria is still in heavy development and isn't excepting a non-federating release until January 2025<ref>[https://git.telodendria.io/Telodendria/Telodendria Telodendria README]</ref>.
 == References ==
 <references />

Matrix>Admin: Fixed minor spelling mistakes

2024-01-16T17:13:45Z

Fixed minor spelling mistakes

← Older revision		Revision as of 17:13, 16 January 2024
Line 1:		Line 1:
	'''[https://telodendria.io Telodendria]''' is a Matrix [[Homeserver\|homeserver]] in alpha written in C99(previously C89)<ref>Cytoplasm, which Telodendria depends on [https://git.telodendria.io/Telodendria/Cytoplasm/issues/28 has switched to using C99 features]</ref>, that aims to extremely powerful yet lightweight, while ~~all~~ being as POSIX-compliant as possible.		'''[https://telodendria.io Telodendria]''' is a Matrix [[Homeserver\|homeserver]] implementation currently in alpha, written in C99 (previously C89)<ref>Cytoplasm, which Telodendria depends on [https://git.telodendria.io/Telodendria/Cytoplasm/issues/28 has switched to using C99 features]</ref>, that aims to be extremely powerful yet lightweight, while being as POSIX-compliant as possible.

	Telodendria is still in heavy development and isn't excepting a non-federating release until January 2025<ref>[https://git.telodendria.io/Telodendria/Telodendria Telodendria README]</ref>.		Telodendria is still in heavy development and isn't excepting a non-federating release until January 2025<ref>[https://git.telodendria.io/Telodendria/Telodendria Telodendria README]</ref>.

Matrix>LDA: oops, All Carriage Returns!

2024-01-16T17:10:16Z

oops, All Carriage Returns!

← Older revision		Revision as of 17:10, 16 January 2024
Line 1:		Line 1:
	'''[https://telodendria.io Telodendria]''' is a Matrix [[Homeserver\|homeserver]] in alpha written in C99(previously C89)<ref>Cytoplasm, which Telodendria depends on [https://git.telodendria.io/Telodendria/Cytoplasm/issues/28 has switched to using C99 features]</ref>.		'''[https://telodendria.io Telodendria]''' is a Matrix [[Homeserver\|homeserver]] in alpha written in C99(previously C89)<ref>Cytoplasm, which Telodendria depends on [https://git.telodendria.io/Telodendria/Cytoplasm/issues/28 has switched to using C99 features]</ref>, that aims to extremely powerful yet lightweight, while all being as POSIX-compliant as possible.
	, that aims to extremely powerful yet lightweight, while all being as POSIX-compliant as possible.

	Telodendria is still in heavy development and isn't excepting a non-federating release until January 2025<ref>[https://git.telodendria.io/Telodendria/Telodendria Telodendria README]</ref>.		Telodendria is still in heavy development and isn't excepting a non-federating release until January 2025<ref>[https://git.telodendria.io/Telodendria/Telodendria Telodendria README]</ref>.

Matrix>LDA at 17:09, 16 January 2024

2024-01-16T17:09:47Z

← Older revision		Revision as of 17:09, 16 January 2024
Line 1:		Line 1:
	'''Telodendria''' is a Matrix [[Homeserver\|homeserver]] in alpha written in C99(previously C89)<ref>Cytoplasm, which Telodendria depends on [https://git.telodendria.io/Telodendria/Cytoplasm/issues/28 has switched to using C99 features]</ref>.		'''[https://telodendria.io Telodendria]''' is a Matrix [[Homeserver\|homeserver]] in alpha written in C99(previously C89)<ref>Cytoplasm, which Telodendria depends on [https://git.telodendria.io/Telodendria/Cytoplasm/issues/28 has switched to using C99 features]</ref>.
	, that aims to extremely powerful yet lightweight, while all being as POSIX-compliant as possible.		, that aims to extremely powerful yet lightweight, while all being as POSIX-compliant as possible.

← Older revision		Revision as of 19:01, 16 January 2024
Line 1:		Line 1:
	'''[https://telodendria.io Telodendria]''' is a Matrix [[Homeserver\|homeserver]] in alpha written in C99(previously C89)<ref>Cytoplasm, which Telodendria depends on [https://git.telodendria.io/Telodendria/Cytoplasm/issues/28 has switched to using C99 features]</ref>, that aims to extremely powerful yet lightweight, while all being as POSIX-compliant as possible.		'''[https://telodendria.io Telodendria]''' is a Matrix [[Homeserver\|homeserver]] in alpha written in C99 (previously C89)<ref>Cytoplasm, which Telodendria depends on [https://git.telodendria.io/Telodendria/Cytoplasm/issues/28 has switched to using C99 features]</ref>, that aims to extremely powerful yet lightweight, while all being as POSIX-compliant as possible.

	Telodendria is still in heavy development and isn't excepting a non-federating release until January 2025<ref>[https://git.telodendria.io/Telodendria/Telodendria Telodendria README]</ref>.		Telodendria is still in heavy development and isn't excepting a non-federating release until January 2025<ref>[https://git.telodendria.io/Telodendria/Telodendria Telodendria README]</ref>.
Line 11:		Line 11:
	The configuration is stored in a JSON file called <code>[dir]/config.json</code>, which contains the following properties:		The configuration is stored in a JSON file called <code>[dir]/config.json</code>, which contains the following properties:
	* <code>listen</code>: A required object list (Telodendria supports multiple listeners) storing ''where'' Telodendria should listen for requests:		* <code>listen</code>: A required object list (Telodendria supports multiple listeners) storing ''where'' Telodendria should listen for requests:
	** <code>port</code>: A required integer(between 1 and 65535) representing what port Telodendria listens to.		** <code>port</code>: A required integer (between 1 and 65535) representing what port Telodendria listens to.
	** <code>maxConnections</code>: An optional integer, defining the maximal amount of connections the listener should accept, which is 32 by default. You should play around, and see what values work the best for your loads.		** <code>maxConnections</code>: An optional integer, defining the maximal amount of connections the listener should accept, which is 32 by default. You should play around, and see what values work the best for your loads.
	** <code>threads</code>: An optional integer, defining the amount of threads the listener sets up, which is 4 by default. You should play around, and see what values work the best for your loads.		** <code>threads</code>: An optional integer, defining the amount of threads the listener sets up, which is 4 by default. You should play around, and see what values work the best for your loads.
Line 26:		Line 26:
	*** <code>"warning"</code>		*** <code>"warning"</code>
	*** <code>"error"</code>		*** <code>"error"</code>
	** <code>timestampFormat</code>: Represents the format Telodendria uses to write time information(see <code>strftime</code> for more).		** <code>timestampFormat</code>: Represents the format Telodendria uses to write time information (see <code>strftime</code> for more).
	** <code>color</code>: A boolean, determining whenever color should be enabled, whenever possible(if on an ANSI terminal)		** <code>color</code>: A boolean, determining whenever color should be enabled, whenever possible (if on an ANSI terminal)
	* <code>runAs</code>: An object, that determines what user(<code>uid</code> as username) and role(<code>gid</code> as rolename) to run as if running as UID 0 (<code>root</code> in most systems)		* <code>runAs</code>: An object, that determines what user (<code>uid</code> as username) and role (<code>gid</code> as rolename) to run as if running as UID 0 (<code>root</code> in most systems)

	* <code>serverName</code>: A required string, representing the server's name to the federation (see [[Delegation]])		* <code>serverName</code>: A required string, representing the server's name to the federation (see [[Delegation]])
Line 39:		Line 39:

	== Compiling Telodendria from Git ==		== Compiling Telodendria from Git ==
	Telodendria only needs a few dependencies: Cytoplasm (which can be built at the same time), a POSIX-compliant <code>libc</code> (with pthread support), and an optional TLS library(OpenSSL/LibreSSL).		Telodendria only needs a few dependencies: Cytoplasm (which can be built at the same time), a POSIX-compliant <code>libc</code> (with pthread support), and an optional TLS library (OpenSSL/LibreSSL).

	To build it, you can first install Cytoplasm if your distribution supports it.		To build it, you can first install Cytoplasm if your distribution supports it.