Atlassian Connect Confluence Development Environment

This is a set of Vagrant / Puppet provisioning scripts for provisioning a local Atlassian Connect development environment. To build an Atlassian Connect Add-ons, you have two choices:

  1. You can build your add-on locally and then register it in an OnDemand instance to test it.
  2. You can build your add-on locally and then register it inside a local version JIRA or Confluence.

These provisioning scripts will allow you to build your add-on using option #2 above.


First, install VirtualBox and Vagrant and make sure you have git available.

Open your favorite terminal and add a "base" virtual machine:

vagrant box add base

Clone the atlassian-connect-confluence-vagrant project by typing at your command line:

git clone
cd atlassian-connect-confluence-vagrant

Start up and provision automatically all dependencies in the vm:

vagrant up

The last step will provision your local Confluence server and run Confluence. It will take anywhere from 3-5 minutes for your server to be provisioned depending on the speed of your computer. Once it's done, you can access Confluence at:

http://localhost:1990/confluence (admin/admin)

Registering your Atlassian Connect Add-on

Once your Confluence server is up and running, you can register your add-on by posting to installer resource:

curl -v -u admin -X POST -d url=http://machine_hostname/path/to/your/atlassian-plugin.xml http://localhost:1990/confluence/rest/remotable-plugins/latest/installer

Notice the URL we're posting to the Atlassian Connect installer (http://machine_hostname/path/to/your/atlassian-plugin.xml). The machine_hostname used here refers to your local machine's hostname. If you're on OSX, this typically will be your machine_name.local. You'll need to use the same hostname in your atlassian-plugin.xml:

<remote-plugin-container key="container" display-url="http://machine_name.local:{port}">

This hostname is important since it needs to be accessible from within the guest VM as well as through the browser on the host machine.


This is a proof of concept Atlassian Connect development environment. There are other ways to do this, but if this helps please contribute.