LinuxCommandLibrary

prosodyctl

Control and manage the Prosody XMPP server

TLDR

Start server

$ prosodyctl start
copy
Stop server
$ prosodyctl stop
copy
Check status
$ prosodyctl status
copy
Add user
$ prosodyctl adduser [user@domain.com]
copy
Delete user
$ prosodyctl deluser [user@domain.com]
copy
Change password
$ prosodyctl passwd [user@domain.com]
copy
Check configuration
$ prosodyctl check
copy
Reload configuration
$ prosodyctl reload
copy

SYNOPSIS

prosodyctl command [args]

DESCRIPTION

prosodyctl is the administration tool for the Prosody XMPP/Jabber server, providing service control, user management, and configuration validation from the command line. It can start, stop, restart, and reload the server, with reload applying configuration changes without disconnecting users.
User management commands handle XMPP account lifecycle: creating accounts with adduser, removing them with deluser, and resetting passwords with passwd. All user operations use JID (Jabber ID) format like user@domain.com.
The check command validates the Prosody configuration, DNS records, and TLS certificates before applying changes, catching common setup errors. Certificate management commands help import, generate, and inspect TLS certificates needed for secure XMPP connections.

PARAMETERS

start

Start Prosody.
stop
Stop Prosody.
restart
Restart Prosody.
status
Show status.
reload
Reload configuration.
adduser JID
Create user account.
deluser JID
Delete user account.
passwd JID
Change password.
check
Validate configuration.
about
Version and paths.
cert
Certificate management.

CAVEATS

Requires root for most operations. Some commands need Prosody running. JID format required for users.

HISTORY

Prosody was started by Matthew Wild in 2008 as a lightweight XMPP server. It's known for being modular, standards-compliant, and memory-efficient.

SEE ALSO

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community