Undeploy AMP files from Alfresco

As per the development guidelines provided by Alfresco for recent versions, the best way to deploy customizations is through AMP (Alfresco Module Package) form.

Advantages of using AMP

  • Easy to deploy
  • Easy to maintain the customization as everything bundled in to one package.
  • Easy to undeploy to remove all customization

In this article, I am going to discuss how to undeploy your AMP file from Alfresco to remove any and any and all customizations.

Option 1:(Using backup WAR)

After applying an AMP file for the very first time, Alfresco will create a backup of alfresco.war and share.war in your web apps. You can revert back to these files to remove any customizations you may have made. To do this:

  • Stop Alfresco server.
  • Delete existing alfresco.war, share.war
  • Delete explored folder alfresco and share.
  • Rename old back up of war files to alfresco.war and share.war.
  • Start Alfresco server.

Alfresco Webapp

You can refer the image where all files which are rounded with red should be deleted and files which are rounded with green has to renamed.

Option 2: (Using Module Management Tool)

Under <ALF_HOME>/bin folder of your Alfresco installation you could see that there is one batch file and one executable jar file(alfresco-mmt.jar) is available.That alfresco-mmt.jar contatins module management utility of alfresco.

It helps to install and uninstall amp files from alfresco.

Command to uninstall amp file is as follow.

java -jar bin/alfresco-mmt.jar uninstall <ModuleId> <WARFileLocation>


  • ModuleID–> It represent the name of your amp which you want to uninstall from alfresco
  • WarFileLocation–> Specify the location of war files which are placed under webapp folder. This is require to decide module has to be uninstall from alfresco or share.

This is easier method compare to first one but manual operations comes in handy when things go wrong. Once you execute above command you should be able to see changes in size of war file which is available under your webapp.

Looking for quality Alfresco Web Hosting? Look no further than Arvixe Web Hosting!

Tags: , , , , | Posted under Alfresco | RSS 2.0

Author Spotlight


I love opensource technologies working with those technologies from the time I have stepped in to the Software Industry. Alfresco CMS is my area of expertise. I have worked on various complex implementations which involved integration of Alfresco with other technologies, extensively worked with JBPM workflows and Webscripts.

One Comment on Undeploy AMP files from Alfresco

  1. Bindu Wavell says:

    Unfortunately once you’ve done this you still have a module entry in Alfresco and you’ll see complaints every time you boot. Additionally if your amp bootstrapped anything, this process would not remove those items.

Leave a Reply

Your email address will not be published. Required fields are marked *