Maintenance for Jira allows administrators to easily put Jira into maintenance mode.
Having this option to switch Jira into maintenance mode can be very useful for administrators, especially when planning daily maintenance / migration / upgrades or updates on a separate instance and planning the switch after testing is complete, during which you can control who has access to Jira and can make any changes.
How to use Maintenance mode
Jira Administrators can enable this mode and configure a service landing page for this mode for all users who will not have access to the system
Go to Administration->Manage apps and selectMaintenance in section Maintenance for Jira
Enable/Disable Maintenance mode
Enable/Disable maintenance mode is very simple, just switch and save the configuration by clicking Save.
In this section you can also quickly preview what the maintenace landing page will be like
Direct link: JIRA_URL/plugins/servlet/maintenance/status
Enable/Disable Outgoing Mail
On the maintenance mode page you can also quickly switch whether you want to enable/disable outgoing emails - this may be important if you intend to perform actions that may generate sending emails to users
Changing the appearance of the maintenance landing page
On the maintenance mode page you can change the appearance of the landing maintenance page by changing the Main and Detailed Message fields.
Main message is displayed at the top of the page (usually it is e.g. the logo and title or general information about what is happening), while the Details message is displayed at the bottom of the page (here you can place more detailed data, what is happening, break statuses, etc.)
Thanks to the use of Rich Text fields, you can easily create a personalized page for yourself.
Changing the appearance of the application banner
On the maintenance mode page, you can change the appearance of the information banner in the application.
This message is displayed to every user who can log in to the application in service mode, as well as on the login page
Thanks to the use of Rich Text fields, you can easily create a personalized message for yourself.
Managing access to Jira
In maintenance mode, Jira Administrators have access to Jira by default. If you want to grant access to other users (e.g. testers, early adopters, etc.), you can do so by selecting an additional group that will be able to log in to the application.
Whenever a Jira Administrators enables maintenance mode, all user sessions without access to Jira will be automatically invalidated to prevent unwanted changes
REST API availability
For all administrators and people with access to Jira - all methods (GET, PUT, POST, DELETE, etc.) for all REST APIs available in Jira and added by 3rd party plugins work without any changes
For users without access to Jira - GET method for all REST APIs available in Jira and plugins added by 3rd party plugins works without any changes, the remaining methods (e.g. PUT, POST, DELETE, etc.) will return a 403 Forbidden status with the response
"message": "maintenance mode is enabled",
Banner with in-app messages
For all administrators and people with access to Jira, an additional banner will be displayed during maintenance mode informing that this mode is enabled