Troubleshooting Tips

What not to do

Don't delete Adium and reinstall it

This almost never works. It only works for certain very specific types of problems (such as if you “slimmed” your Adium, as mentioned later); if you get to the point of asking us for help, we'll tell you if it's appropriate to try a delete and reinstall.

Otherwise, don't bother to try it—it won't help.

What you should do

If you're having trouble with Adium, please give the following a try:

1) Make sure you're using the newest Adium release

If you're using an older version, the newest release of Adium may already include a fix for your problem.

2) Remove any non-standard Xtras

If you've installed plug-ins or other AdiumXtras, they may be causing your problem (depending on the problem - a contact list style won't cause message view problems, for example). Try this: Quit Adium, then remove the Xtras, then launch Adium again. If that works, start moving Xtras back (relaunching Adium after each one) until the problem reoccurs; then you've found the bad one. Please don't create a ticket for a non-standard Xtra. The Adium team isn't responsible for Xtras that aren't bundled with Adium, and creating a ticket isn't an effective way to get the Xtra fixed. Please report the problem to the Xtra's author.

Information on removing and (re)installing Xtras is available in the AdiumXtras documentation.

3) Try a fresh set of preferences

Corrupt or old preferences can be a good source of crashes and other odd behavior. It may also happen that you've managed to configure your Adium in such a way to discover a bug that requires a specific combination of preferences to trigger. It's easy to rule out both of these by trying a fresh set of preferences; see the Adium preferences documentation.

This is a very common fix for many issues and therefore is a highly recommended step - please try it even if you don't want to trash your preferences altogether since it can at least help narrow down the problem and may provide alternate solutions. In many cases where this solves the problem we do not have the manpower to discover why the preferences were causing a problem (as this can be a lengthy process), so your only solution may be to lose all or some of your preferences.

4) Try a fresh user account

Occasionally, an issue in Adium can be caused by a strange setting for your OS X user, or other installed software (especially system mods and hacks). Temporarily creating a new user (in System Preferences → Accounts) is the best way to check against these issues. Create the account, log out of your account (Apple Menu → Log Out), and log into the new one. If the problem doesn't occur on the other user account, then you know it's something in your current account. If you don't know where to go from there, ContactUs and we'll help you narrow the field.

5) Try another client

In some cases the problems encountered in Adium can actually be a result of a server-side problem. These problems can be confirmed by logging in to your account using the equivalent mainline client; for example if the problem is with MSN, login with Microsoft Messenger to see if it occurs using that client as well. If the problem persists across different clients, then there is likely nothing we can do to solve the problem except wait for the server issues to be repaired; please do not open new tickets regarding these kinds of problems.

If it still doesn't work

Still have your problem? Now it's time to search for any existing documentation or report of your problem.

Not sure whether the problem lies with Adium? Ask on the Adium forums, in the Adium IRC channel, or on

Page last modified by Robert, 10 years ago