Start and Stop Jira applications

How you start and stop your Jira application depends on whether you are running Jira as a Service. 

Windows

When installed as a service...

If you installed Jira as a service, you can Start Jira Server and Stop Jira Server from the Windows Start menu. 

You can't start or stop Jira manually using the start-jira.bat and stop-jira.bat file.

Manually when not installed as a service...

If you didn't install Jira as a service you'll need to start and stop Jira manually.

  • To start Jira run <installation-directory>\bin\start-jira.bat
  • To stop Jira run <installation-directory>\bin\stop-jira.bat

We recommend running Jira with a dedicated user account. To do this, use use the runas command to execute start-jira.bat.

> runas /env /user:<DOMAIN>\<jira> start-jira.bat

Where <DOMAIN> is your Windows domain or computer name and <jira> is the name of your dedicated user.

Manual start with apps disabled...

Jira can be started with all non-system apps, or a selection of these apps, disabled. This helps with troubleshooting when these non-system apps are causing issues with your Jira instance, such as causing Jira to fail on start up, or when the app is malfunctioning and can't be removed through UPM. The parameters do not persist, that is, they are applied at start up once, and if you need to restart Jira, you need to apply them again.

The parameters should be specified at system start up when Jira is started using the start-jira.bat file, for example:

<installation-directory>/bin/start-jira.bat /disablealladdons /disableaddons=com.atlassian.test.plugin

If you don't use start-jira.bat for starting Jira, but still wish to use this feature, you can add the following JVM parameter to the invocation of the servlet container that's running Jira:

-Datlassian.plugins.startup.options="/disablealladdons /disableaddons=com.atlassian.test.plugin"

To disable multiple apps, use a colon separated list of apps. Regex/wildcards are not permitted, the full key of the app must be provided, for example:

-Datlassian.plugins.startup.options="/disablealladdons /disableaddons=com.atlassian.test.plugin:com.atlassian.another.test.plugin"

Notes

  • If the app key contains a space, this feature will not work, you need to manually deal with that app.
  • This feature does not work for Jira Data Center applications.
  • This can be used to disable an app deemed critical to Jira starting, and if one of those is disabled, Jira will fail to start

  • This can can be used to disable Jira application OBR bundles, for example, to stop the Jira Software app:

    <installation-directory>/bin/start-jira.bat /disableaddons=com.atlassian.jira.jira-software-application

Linux 

When installed as a service...

If you installed Jira as a service, use one of the following commands to start or stop Jira.

$ sudo /etc/init.d/jira start
$ sudo /etc/init.d/jira stop

You can't start or stop Jira manually using the start-jira.sh and stop-jira.sh files.

Manually when not installed as a service...

If you didn't install Jira as a service you'll need to start and stop Jira manually.

  • To start Jira run <installation-directory>\bin\start-jira.sh
  • To stop Jira run <installation-directory>\bin\stop-jira.sh


We recommend running Jira with a dedicated user account:

$ su -u <user>
$ ./start-jira.sh

Where <user> is the name of your dedicated user.

If you're using Ubuntu the command is a little different:

$ sudo su <user>
$ ./start-jira.sh
Manual start with apps disabled...

Jira can be started with all non-system apps, or a selection of these apps, disabled. This helps with troubleshooting when these non-system apps are causing issues with your Jira instance, such as causing Jira to fail on start up, or when the app is malfunctioning and can't be removed through UPM. The parameters do not persist, that is, they are applied at start up once, and if you need to restart Jira, you need to apply them again.

The parameters should be specified at system start up when Jira is started using the start-jira.sh script, for example:

./bin/start-jira.sh --disable-all-addons --disable-addons=com.atlassian.test.plugin

If you don't use start-jira.sh for starting Jira, but still wish to use this feature, you can add the following JVM parameter to the invocation of the servlet container that's running Jira:

-Datlassian.plugins.startup.options="--disable-all-addons --disable-addons=com.atlassian.test.plugin"

To disable multiple apps, use a colon separated list of apps. Regex/wildcards are not permitted, the full key of the app must be provided, for example:

-Datlassian.plugins.startup.options="--disable-all-addons --disable-addons=com.atlassian.test.plugin:com.atlassian.another.test.plugin"

Notes

  • --disable-addons takes a colon-separated list (chosen as a colon is the only prohibited character from an app key) of addons to be disabled. These can be system apps.
  • This feature does not work for Jira Data Center applications.
  • This can be used to disable an app deemed critical to Jira starting, and if one of those is disabled, Jira will fail to start

  • This can can be used to disable Jira application OBR bundles, for example, to stop the Jira Software app:

    ./bin/start-jira.sh --disable-addons=com.atlassian.jira.jira-software-application







Last modified on Dec 9, 2021

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.