Zimbra Talk/How to delete a groupchat using the CLI

How to delete a groupchat using the CLI

   KB 23042        Last updated on 09/24/2016  

(0 votes)
Article-check.png  - This is certified documentation and is protected for editing by Zimbra Employees & Moderators only.

Incident description

How to delete a groupchat using the CLI

Resolution description

When creating a chatroom there are 2 options implemented as switches:

  • Delete chat stream after closing
    • this is on by default, meaning the chatroom is deleted when all participants leave, it remains accessible as long as there is at least one participant
    • if this is turned off, the chatroom becomes persistent. See below for information on how to delete the room manually from commnd line
  • Hide chat streams from new participants
    • this is turned off by default, making the chatroom public (visible to all users of this domain)
    • if it is turned on, the chat is not publicly visible

So - users can select the behaviour here and chose what they want.


To delete persistent chatrooms manually on talk server you need the full jid of the room. Usually this is <roomname>@conference.<userdomain.tld>. To fetch a list of persistent chatrooms execute as root:

echo "select key from prosody where store='persistent';" | su - postgres -c "psql prosody -A -t" 

You will see the list of your persistent chatrooms like for example:


To delete a chatroom execute on talk server (where jid is 5e69hiag@conference.zimbra.io for example):

echo "muc:room(\"5e69hiag@conference.zimbra.io\"):destroy()" | nc localhost 5582
|                    ____                \   /     _
                    |  _ \ _ __ ___  ___  _-_   __| |_   _
                    | |_) | '__/ _ \/ __|/ _ \ / _` | | | |
                    |  __/| | | (_) \__ \ |_| | (_| | |_| |
                    |_|   |_|  \___/|___/\___/ \__,_|\__, |
                    A study in simplicity            |___/

| Welcome to the Prosody administration console. For a list of commands, type: help
| You may find more help on using this console in our online documentation at 
| http://prosody.im/doc/console

| Result: nil

Reasons and prerequisites

Delete persistent chatrooms

Zimbra Talk


Latest Version: 2.3

Zimbra Talk Resources

Here you can find useful resources for your Zimbra Talk environment

Verified Against: Zimbra Collaboration Suite 8.7, 8.6 Date Created: 05/08/2016
Article ID: https://wiki.zimbra.com/index.php?title=Zimbra_Talk/How_to_delete_a_groupchat_using_the_CLI Date Modified: 09/24/2016

Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »

Wiki/KB reviewed by Jorge SME2 Copyeditor Last edit by Jorge de la Cruz Mingo
Jump to: navigation, search