view mod_alias/README.markdown @ 4575:5b4f43b90766

mod_measure_malloc: port to most recent trunk statistics API
author Jonas Schäfer <>
date Tue, 25 May 2021 19:01:54 +0200
parents ea6b5321db50
line wrap: on
line source

summary: Point alias accounts or domains to correct XMPP user


This module allows you to set up aliases that alert people who try to
contact them or add them to their roster what your actual JID is.  This
is useful for changing JIDs, or just in the case where you own both and, and want people who contact
to be alerted to contact you at instead.

This type of aliasing is well supported in the email world, but very hard
to handle with XMPP, this module sidesteps all the hard problems by just
sending the user a helpful message, requiring humans to decide what they
actually want to do.

This doesn't require any special support on other clients or servers,
just the ability to receive messages.


Add the module to the `modules_enabled` list.

    modules_enabled = {

Then set up your list of aliases, aliases can be full or bare JIDs,
or hosts:

    aliases = {
        [""] = "";
        [""] = "";
        [""] = "";

You can also set up a custom response, by default it is:

    alias_response = "User $alias can be contacted at $target";

A script named is included in this directory to
generate the aliases array directly from a postfixadmin MySQL database.
Instructions for use are included in the script.


  ------- --------------
  trunk   Works
  0.10    Works
  0.9     Unknown
  0.8     Unknown
  ------- --------------