Prosody - Revision history

Tie-ling: rm redundant config

2025-09-27T02:16:41Z

rm redundant config

← Older revision		Revision as of 02:16, 27 September 2025
Line 19:		Line 19:
	description = "http upload";		description = "http upload";
	url = "upload.xmpp.${domainName}";		url = "upload.xmpp.${domainName}";
	}
	{
	~~description = "multi user chat";~~
	~~url = "muc.xmpp.${domainName}";~~
	}		}
	];		];
Line 101:		Line 97:
	}		}
	];		];
	~~disco_items = [~~		}
	{
	~~description = "multi user chat";~~
	~~url = "muc.xmpp.${domainName}";~~
	}
	];
	}
	</syntaxhighlight>		</syntaxhighlight>

Line 121:		Line 111:
	# xmpp server for "@example.org" is hosted on "xmpp.example.org"		# xmpp server for "@example.org" is hosted on "xmpp.example.org"
	# use SRV records.		# use SRV records.
	"~~xmpp.${domainName}~~" = {		"myvhost0" = {
	domain = "${domainName}";		domain = "${domainName}";
	enabled = true;		enabled = true;
Line 200:		Line 190:
	== Connect to prosody ==		== Connect to prosody ==
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	services.prosody.virtualHosts."~~xmpp.${domainName}~~".extraConfig = ''		services.prosody.virtualHosts."myvhost0".extraConfig = ''
	turn_external_host = "turn.xmpp.${domainName}"		turn_external_host = "turn.xmpp.${domainName}"
	turn_external_secret = "unfortunately this is a inline password"		turn_external_secret = "unfortunately this is a inline password"
Line 282:		Line 272:
	http_upload_external_base_url = "https://upload.xmpp.${domainName}/upload/"		http_upload_external_base_url = "https://upload.xmpp.${domainName}/upload/"
	http_upload_external_file_size_limit = 52428800		http_upload_external_file_size_limit = 52428800
	~~-- Grant permissions for users on the '${domainName}' VirtualHost~~
	~~parent_host = "${domainName}"~~
	'';		'';
	services.prosody.disco_items = [		services.prosody.disco_items = [

Tie-ling: at -> on

2025-09-27T01:10:58Z

at -> on

← Older revision		Revision as of 01:10, 27 September 2025
Line 11:		Line 11:
	* Domain of the xmpp address is the bare top level domain example.org. The bare top level domain has SRV records pointing to XMPP server xmpp.example.org.		* Domain of the xmpp address is the bare top level domain example.org. The bare top level domain has SRV records pointing to XMPP server xmpp.example.org.

	* XMPP server is hosted at xmpp.example.org.		* XMPP server is hosted on xmpp.example.org.

	* XMPP services, such as STUN/TURN server, Multi-User Chat and HTTP upload are hosted at .xmpp.example.org. As .xmpp.example.org is not a direct subdomain of example.org, we need to set mod_disco to let XMPP client to discover the services.		* XMPP services, such as STUN/TURN server, Multi-User Chat and HTTP upload are hosted at .xmpp.example.org. As .xmpp.example.org is not a direct subdomain of example.org, we need to set mod_disco to let XMPP client to discover the services.
Line 26:		Line 26:
	];		];
	</syntaxhighlight>		</syntaxhighlight>
	* STUN/TURN server is hosted at turn.xmpp.example.org.		* STUN/TURN server is hosted on turn.xmpp.example.org.
	* Multi-User Chat is hosted at muc.xmpp.example.org.		* Multi-User Chat is hosted on muc.xmpp.example.org.
	* HTTP upload server is hosted at upload.xmpp.example.org.		* HTTP upload server is hosted on upload.xmpp.example.org.

	= SSL Certificate with ACME =		= SSL Certificate with ACME =

Tie-ling: domain and disco config

2025-09-27T01:10:04Z

domain and disco config

← Older revision		Revision as of 01:10, 27 September 2025
Line 8:		Line 8:

	See official Prosody documentation here [https://prosody.im/doc/dns].		See official Prosody documentation here [https://prosody.im/doc/dns].

			* Domain of the xmpp address is the bare top level domain example.org. The bare top level domain has SRV records pointing to XMPP server xmpp.example.org.

			* XMPP server is hosted at xmpp.example.org.

			* XMPP services, such as STUN/TURN server, Multi-User Chat and HTTP upload are hosted at .xmpp.example.org. As .xmpp.example.org is not a direct subdomain of example.org, we need to set mod_disco to let XMPP client to discover the services.
			<syntaxhighlight lang="nix">
			services.prosody.disco_items = [
			{
			description = "http upload";
			url = "upload.xmpp.${domainName}";
			}
			{
			description = "multi user chat";
			url = "muc.xmpp.${domainName}";
			}
			];
			</syntaxhighlight>
			* STUN/TURN server is hosted at turn.xmpp.example.org.
			* Multi-User Chat is hosted at muc.xmpp.example.org.
			* HTTP upload server is hosted at upload.xmpp.example.org.

	= SSL Certificate with ACME =		= SSL Certificate with ACME =
Line 77:		Line 98:
	{		{
	domain = "muc.xmpp.${domainName}";		domain = "muc.xmpp.${domainName}";
	~~# only admin can create public channels~~		restrictRoomCreation = false;
	~~# everyone can create private~~ chat ~~rooms~~		}
	~~restrictRoomCreation~~ = ~~true~~;		];
			disco_items = [
			{
			description = "multi user chat";
			url = "muc.xmpp.${domainName}";
	}		}
	];		];
Line 260:		Line 285:
	parent_host = "${domainName}"		parent_host = "${domainName}"
	'';		'';
	services.prosody.~~virtualHosts."xmpp.${domainName}".extraConfig~~ = ''		services.prosody.disco_items = [
	~~disco_items~~ = {		{
	{ "upload.${domainName}"~~, "http upload" }~~;		description = "http upload";
			url = "upload.xmpp.${domainName}";
	}		}
	'';		];

	# mod_http_upload_external is a community module		# mod_http_upload_external is a community module

Tie-ling: add link to dns set up

2025-09-20T05:53:37Z

add link to dns set up

← Older revision		Revision as of 05:53, 20 September 2025
Line 5:		Line 5:
	This page describes how to setup a walled-off Prosody instance for your organisation or family, with STUN/TURN support and http upload. This setup has server-to-server communication disabled.		This page describes how to setup a walled-off Prosody instance for your organisation or family, with STUN/TURN support and http upload. This setup has server-to-server communication disabled.

			= Set up DNS records for Prosody =

			See official Prosody documentation here [https://prosody.im/doc/dns].

	= SSL Certificate with ACME =		= SSL Certificate with ACME =

Tie-ling: /* Connect filer to Prosody */ grant permission for prosody-filer

2025-09-19T23:07:36Z

Connect filer to Prosody: grant permission for prosody-filer

← Older revision		Revision as of 23:07, 19 September 2025
Line 254:		Line 254:
	http_upload_external_base_url = "https://upload.xmpp.${domainName}/upload/"		http_upload_external_base_url = "https://upload.xmpp.${domainName}/upload/"
	http_upload_external_file_size_limit = 52428800		http_upload_external_file_size_limit = 52428800
			-- Grant permissions for users on the '${domainName}' VirtualHost
			parent_host = "${domainName}"
	'';		'';
	services.prosody.virtualHosts."xmpp.${domainName}".extraConfig = ''		services.prosody.virtualHosts."xmpp.${domainName}".extraConfig = ''

Tie-ling: add final checkup

2025-09-19T22:53:05Z

add final checkup

← Older revision		Revision as of 22:53, 19 September 2025
Line 275:		Line 275:
	</syntaxhighlight>		</syntaxhighlight>

			= Final Checkup =

			Run prosodyctl check to check for local configuration and DNS setup errors.

	[[Category:Server]]		[[Category:Server]]
	[[Category:NixOS Manual]]		[[Category:NixOS Manual]]

Tie-ling: reason for prosody-filer

2025-09-19T14:09:26Z

reason for prosody-filer

← Older revision		Revision as of 14:09, 19 September 2025
Line 181:		Line 181:
	= http upload with prosody-filer and nginx =		= http upload with prosody-filer and nginx =

			Although newer prosody versions does not require external http upload to run,
			prosody-filer is still more performant than the built-in server. [https://github.com/ThomasLeister/prosody-filer/issues/39]
	== Open firewall ports ==		== Open firewall ports ==
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">

Tie-ling: add detailed config

2025-09-19T08:47:43Z

add detailed config

Show changes

Klinger: first version with link to manual

2024-05-16T15:40:57Z

first version with link to manual

New page

[https://prosody.im/ Prosody] is an open-source, modern XMPP server.

It is documented in the [https://nixos.org/manual/nixos/stable/#module-services-prosody NixOS manual].

[[Category:Server]]
[[Category:NixOS Manual]]