Start a Host Application with a Plugin Installed
You can use the Atlassian Plugin SDK to download the Atlassian host application binaries, run a plugin's unit tests, install a plugin (skeleton) and start the host application. When you are done, you can visit the application in your browser, log in as 'admin/admin', and see your plugin in action.
- Open a command window and go to the folder where your plugin's
This is the folder where you created your plugin skeleton.
atlas-runand press Enter.
The download can be slow the first time you do it. But the next time you execute the
runcommand, it will be much faster because all the binaries are in your local Maven repository. When all the downloads and installation are complete, the system display a message similar to the following:
- Open your browser and go to the URL given in the message.
For example, in the message above the URL is http://localhost:1990/confluence for Confluence. The application's login screen appears.
- Log in with username
- Find your plugin to confirm that it was deployed.
- Maven Cannot Find Java Mail, Java Activation or JTA
- BeanCreationException from Spring Framework
- Specifying a particular version of the host application
- For other errors, please refer to the FAQ and troubleshooting section.
About the Application Source Code
Please note: The plugin now knows about the host application's binaries, because it has downloaded the JAR files. But it has not downloaded the application source code. You do not need to have access to the host application's source code to be able to develop a plugin. The JAR files alone will enable you to go and write the plugin, using the application's API.
If you hold a commercial license for an Atlassian application with access to the source code, you can attach the application source code to your plugin project. See how to use the Atlassian Plugin SDK with a source code license.