Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
CQ5 curl commands
Note 1: The following CQ curl commands assumes a admin:admin username and password.
Note 2: For Windows/Powershell users: use two "" when doing a -F cURL command.
Example: -F"":operation=delete""
Note 3: Quotes around name of package (or name of zip file, or jar) should be included.
Uninstall a bundle (use http://localhost:4505/system/console/bundles to access the Apache Felix web console)
curl -u admin:admin -daction=uninstall http://localhost:4505/system/console/bundles/"name of bundle"
Install a bundle
curl -u admin:admin -F action=install -F bundlestartlevel=20 -F
bundlefile=@"name of jar.jar" http://localhost:4505/system/console/bundles
Build a bundle
curl -u admin:admin -F bundleHome=/apps/centrica/bundles/name of bundle -F
Stop a bundle
curl -u admin:admin http://localhost:4505/system/console/bundles/
-F action=stop
Start a bundle
curl -u admin:admin http://localhost:4505/system/console/bundles/
-F action=start
Delete a node (hierarchy) - (this will delete any directory / node / site)
curl -X DELETE http://localhost:4505/path/to/node/jcr:content/nodeName -u admin:admin
Upload a package AND install
curl -u admin:admin -F file=@"name of zip file" -F name="name of package"
-F force=true -F install=true http://localhost:4505/crx/packmgr/service.jsp
Upload a package DO NOT install
curl -u admin:admin -F file=@"name of zip file" -F name="name of package"
-F force=true -F install=false http://localhost:4505/crx/packmgr/service.jsp
Rebuild an existing package in CQ
curl -u admin:admin -X POST http://localhost:4505:/crx/packmgr/service/.json/etc/packages/
Download (the package)
curl -u admin:admin http://localhost:4505/etc/packages/export/ > name of local package file
Upload a new package
curl -u admin:admin -F package=@"" http://localhost:4505/crx/packmgr/service/.json/?cmd=upload
Install an existing package
curl -u admin:admin -X POST http://localhost:4505/crx/packmgr/service/.json/etc/packages/export/name of package?cmd=install
curl -u admin:admin -X POST -F path="/content/path/to/page" -F cmd="activate" http://localhost:4502/bin/replicate.json
curl -u admin:admin -X POST -F path="/content/path/to/page" -F cmd="deactivate" http://localhost:4502/bin/replicate.json
Tree Activation
curl -u admin:admin -F cmd=activate -F ignoredeactivated=true -F onlymodified=true
-F path=/content/geometrixx http://localhost:4502/etc/replication/treeactivation.html
Lock page
curl -u admin:admin -X POST -F cmd="lockPage" -F path="/content/path/to/page" -F "_charset_"="utf-8" http://localhost:4502/bin/wcmcommand
Unlock page
curl -u admin:admin -X POST -F cmd="unlockPage" -F path="/content/path/to/page" -F "_charset_"="utf-8" http://localhost:4502/bin/wcmcommand
Copy page
curl -u admin:admin -F cmd=copyPage -F destParentPath=/path/to/destination/parent -F srcPath=/path/to/source/locaiton http://localhost:4502/bin/wcmcommand
Further Resources:
Copy link

ashwani-sahni commented Apr 9, 2013

How can we execute XPATH query using cURL command?

Copy link

sergeimuller commented Jun 26, 2013

@ashwani-sahni - Have a look at

I'm not sure about XPATH over curl, but you can run queries against the querybuilder interface if that will help you achieve what's necessary.

If you're not very familiar with querybuilder, ensure that you download Alexander Klimetschek's PDF from in the 2011 content.

Copy link

mohiaror commented Aug 5, 2014

Hi Sergie,

Is there a way to use curl command to install the subpackages of a package in AEM? Basically, I have a package and it includes two more packages. One of that package has a dependency on another one so that they install one after the other (when I install the main package from package manager). When I tried installing the main package using curl command, it just unwrapped the package and exposed both subpackages but it didn't install them. Is there a way to force install them? Also, will it take care of the dependency of one on another?


Copy link

cpilsworth commented Aug 8, 2014

Add a -F recursive=true to install sub packages

Copy link

cpilsworth commented Aug 8, 2014

If you are using these in shell scripts, you may wish to add --fail so that curl returns an error code if the HTTP status code >= 400

Copy link

alifouad991 commented Jan 9, 2015

I have mac and i want to install CQ5 adobe i have no idea how to start i search and i can't find any clear install
please if any body knows help me

Thanks a lot

Copy link

asksmruti commented Feb 6, 2015

I'm doing some sort of manual work for uploading (both new and modify existing) 'Raw Html Files' on Author instance, then activating those content(template files) .
I was looking for some curl option to upload file but that's working. It's setting up the properties as in old template files. and the pages are also not rendering
To Upload File:
curl -u admin:admin -F "jcr:primaryType=cq:Page" -F "jcr:content/jcr:primaryType=cq:PageContent" -F "jcr:content/jcr:title=New Page" -F "jcr:content/sling:resourceType=geometrixx/components/contentpage" http://localhost:4502/content/geometrixx/en/page
=== This command is creating the required page but not rendering anything. Also the properties are not same as in old template file
Curl Command output is showing as succesful

To activate content:
curl -u admin:admin -X POST -F path="/content/path/to/page" -F cmd="activate" http://localhost:4502/bin/replicate.json
==== Command is returning as 'OK' but it's not activating any of the page

I was referring following site for the commands:

Would be helpful if you can provide some solution for this. there are loads of template files and manual activity is too much time consuming also high chance of error

Copy link

fredfokan commented May 13, 2015


I would like to use a curl request called from a scheduler tool like rundeck/jenkins...
Is there a way from your point of view for hiding the password?
I believe using encrypted password from cq5 it could be possible , but have no clue how must be formatted the curl request for doing it to do it....
curl -u admin:$(3456661621623123qw83q8w4qasgasusiwq} ?
Any clue on that ?

Copy link

bjorns commented Sep 7, 2015

Thanks for this @sergeimuller, I've created a command line tool to simplify administering aem using http. Maybe it's useful for someone else:

Copy link

ronnyfm commented Sep 18, 2015

Is there a way to do a tree activation to achieve reactivation of already activated pages but ignoring modified pages?

Copy link

gsharp commented Oct 1, 2015

wondering if there is a way to get json instead of xml from the generic GET on the service:

example: http://localhost:4502/crx/packmgr/service.jsp?cmd=ls

I'm getting xml which could work but I need something that gives all packs and their state without knowing the group names.

The end game is to find out which packs are installed vs uploaded.

Copy link

AnkurAhuja commented Feb 8, 2016

I am trying to Automate the SAML Configuration in AEM 6.1,
Has anyone generated the CURL command to Automate the authentication-service keystore and CURL command to Automate the trust store for uploading the Certificate.

Copy link

ravilution commented Apr 11, 2016

What is the command to replicate a package that is uploaded and installed. In package manager page if you go to more options there is replicate.

Copy link

zapts commented May 12, 2016

Package replication is not best practice. It does not provide a method for uninstallation from the replication receiver servers.

Copy link

ObjectiveTruth commented May 18, 2016

FYI, the field name is optional, if its not included it will just name it whatever the bundle is called

Created this quick bash script to install a package if it doesn't exist in crx. (based on this gist)

Hope it helps

Copy link

wildone commented Jul 1, 2016

have a look at this dudes:
I use this for all automation of deploy, just working on a final touches will release Ansible project for this to make everyones life easier

@gsharp, this is what you are looking for: http://localhost:4502/crx/packmgr/list.jsp
@zapts,that corect use ansible to prep your server
@ravilution, this is how curl -u : -X POST http://localhost:4502/crx/packmgr/service/.json/etc/packages/

Copy link

wildone commented Jul 1, 2016

also I am dumping all my Curl links here they will include these and more

Copy link

dhughes-xumak commented May 24, 2017

@cpilsworth mentioned -F recursive=true. This doesn't seem to be necessary, at least not on AEM 6.1.

Also, if you have a bunch of packages to upload and install, you can put them all in a directory and run:

~$ AEM_PACKAGES_DIR=~/Downloads/aem_packages
~$ AEM_USER_PASS=admin:admin
~$ AEM_HOST_PORT=localhost:4502
~$ for f in $AEM_PACKAGES_DIR/*; do 
     echo "Uploading and installing $f to $AEM_HOST_PORT ($AEM_USER_PASS)" ; 
     curl -u $AEM_USER_PASS -F file=@"$f" -F install=true http://$AEM_HOST_PORT/crx/packmgr/service.jsp ; 

This will iterate over the files in AEM_PACKAGES_DIR and upload/install in listing order. Need to enforce a specific order? Prefix the order-specific packages with a number (eg, and

Copy link

venkyvikram commented Jul 10, 2017

Hi there..

Any body could help me out with, counting the number of bundles through the curl command in AEM 6?


Copy link

nirmaljosehere commented Nov 6, 2017

@venkyvikram - You can use curl -u admin:admin http://localhost:4502/system/console/bundles.json to get the information

Copy link

robothero commented Jul 30, 2018

I am trying to download an AEM Package using curl: curl -u admin:admin http://localhost:4505/etc/packages/export/ > name of local package file , but it its not returning the actual file and I am unable to "extract the archive" can you please assist?

Copy link

schoudry commented Feb 22, 2019

To update the properties of an osgi service

curl -v -u admin:admin -X POST --data "apply=true&di3dUploadRenderUrl=ABC&di3dDownloadUrl=DEF&propertylist=di3dUploadRenderUrl%2Cdi3dDownloadUrl" http://localhost:4502/system/console/configMgr/apps.assets.di3d.impl.DI3DCloudRenderingServiceImpl

Copy link

zapts commented Jun 25, 2020

AEM 6.5 Upload a Digital Asset to the DAM:
curl -u admin:admin -X POST http://server:port/content/dam/folder-name.createasset.html -F"file=@imagename.png"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment