Documentation for JIRA 5.0. Documentation for other versions of JIRA is available too.
JIRA has a number of configuration options that allow your JIRA server to be customised for use within your organisation. These options can be accessed and edited on JIRA's 'General Configuration' page.
To access and edit options on the 'General Configuration' page:
Screenshot 1: General Configuration
The Advanced button at the end of the page is only visible if you have the JIRA System Administrators global permission.
Setting | Description |
---|---|
Title | This is the title that will be displayed on the JIRA login page and the dashboard. It helps identify your installation and its purpose. |
Mode | JIRA can operate in two modes: |
Maximum Authentication Attempts Allowed | The maximum authentication attempts that are allowed before CAPTCHA is shown to a user. If you leave it blank then CAPTCHA will never be shown and users will have unlimited authentication attempts. It is recommended that you set this to a small number (e.g. below 5). |
CAPTCHA on signup | If you are running JIRA in Public mode (see above), it is strongly recommended that you enable CAPTCHA. This will show a CAPTCHA image on signup to prevent spambots from signing up. |
Base URL | The base URL of this JIRA installation. You can only configure JIRA to respond to a single URL and this setting must match the URL that your users request for accessing your JIRA site. You cannot (for example) have a different hostname or URL for internal and external users. This is especially important for JIRA 4.0.x or higher, as any mismatch between this Base URL setting and the URL requested by your JIRA users will cause problems with dashboard gadgets. This URL is also used in outgoing email notifications as the prefix for links to JIRA issues. |
Email from | Specifies the From: header format in notification emails. Default is of the form "John Doe (JIRA) <jira@company.com>". Available variables are '${fullname}', '${email}' and '${email.hostname}'. Note that the actual address (e.g. 'jira@company.com') cannot be specified here - it is determined by the mail server or individual project configuration. |
Introduction | A short introduction message displayed on the dashboard. Also see the announcement banner, which is displayed on every JIRA page. You can include HTML, but ensure all tags are correctly closed. |
Setting | Description |
---|---|
Indexing language | JIRA uses Lucene, a high-performance text search engine library, in full-text searches for issues stored in JIRA. This option is designed to enhance JIRA's search indexing and issue searching features for issues entered in the languages available in this list. Hence, choose the language that matches the language used in your issues. Choosing a specific language in this list has the following effects when conducting searches in JIRA (with respect to your chosen language):
If multiple languages are used in your issues (or you wish to disable the two effects above), choose Other. You will need to re-index JIRA if you change this value. |
Installed languages | This section lists all language packs available within the JIRA system. (Note: to install additional languages, see Internationalisation.) |
Default language | The language used throughout the JIRA interface (as selected from the list displayed in Installed Languages above). Users can override the default language by using the Language setting in their user profile. |
Default user time zone | This is the time zone used throughout the JIRA interface. Users can override the default language by using the Time Zone setting in their user profile. (To choose the time format see Configuring the Layout and Design.) Date fields, which have no time component, such as due dates, release dates (associated with versions) and custom date fields, solely record date information (and no time zone-related information) so are not affected by time zone settings. |
Setting | Description |
---|---|
Allow users to vote on issues | Controls whether voting is enabled in JIRA. Voting allows users to indicate a preference for issues they would like to be completed or resolved. See also the 'View Voters and Watchers' permission. |
Allow users to watch issues | Controls whether watching is enabled in JIRA. Users can 'watch' issues which they are interested in. Users watching an issue will be notified of all changes to it. See also the 'View Voters and Watchers' and 'Manage Watcher List' permissions. |
Allow unassigned issues | When turned ON, JIRA will allow issues to be unassigned or assigned to 'no-one'.When turned OFF, issues must always be assigned to someone - by default, the assignee will be the Project Lead as defined for each project. |
External user management | When turned ON, you will no longer be able to create, edit or delete users/groups from within JIRA (or via email or import); but you can still assign users/groups to project roles, and create/edit/delete user properties. Additionally, JIRA will not display options for users to change their password, or edit their profile. |
Logout confirmation | Controls whether to obtain user's confirmation when logging out: NEVER COOKIE - prompt for confirmation if the user was automatically logged in (via a cookie). ALWAYS |
Use gzip compression | Controls whether to compress the web pages that JIRA sends to the browser. It is recommended that this be turned ON, unless you are using mod_proxy. |
Accept remote API calls | Controls whether to allow remote client access (via XML-RPC or SOAP) to this JIRA installation, for authenticated users. |
User email visibility | Controls how users' email addresses are displayed in the user profile page. |
Comment visibility | Determines what will be contained in the list that is presented to users when specifying comment visibility and worklog visibility. |
Exclude email header 'Precedence: bulk' | Controls whether to prevent the Precedence: Bulk header on JIRA notification emails. This option should only be enabled when notifications go to a mailing list which rejects 'bulk' emails. In normal circumstances, this header prevents auto-replies (and hence potential mail loops). |
Issue Picker Auto-complete | Provides auto-completion of issue keys in the 'Issue Picker' popup screen. Turn OFF if your users' browsers are incompatible with AJAX. |
JQL Auto-complete | Provides auto-completion of search terms when users perform an advanced (JQL) search. Turn OFF if you prefer not to use this feature, or are experiencing a performance impact. |
Internet Explorer MIME Sniffing Security Hole Workaround Policy | Attachment viewing security options for cross-site site scripting vulnerabilities present in Internet Explorer 7 and earlier. Changes the default browser action for attachments in JIRA. Options are: |
Contact Administrators Form | Provides an email form for users to fill in when they click the 'Contact Administrators' link (which appears when appropriate in JIRA, e.g. on Login panels and pages). Applies only if outgoing email is enabled. Can be used with or without the custom 'Contact Administrators Message' below. Users with the JIRA Administrators global permission (not JIRA System Administrators - see JRA-27454 for details) will be notified as a result of this feature being used. |
Contact Administrators Message | Displays a custom message when users click the 'Contact Administrators' link (which appears when appropriate in JIRA, e.g. on Login panels and pages). The 'Contact Administrators Message' will be displayed at the top of the 'Contact Administrators Form', if the form is enabled (see above), or by itself if the form is not enabled. |
JIRA has a small number of commonly edited advanced configuration options, which are stored in the JIRA database. These options can be accessed and edited from the Advanced Settings page.
To access and edit options on the 'Advanced Settings' page:
Edit the value of a Key/Property by clicking its value on the right of the page and modifying the existing value.
Refer to the following Topics for more information about the Keys (above):
Key | Topic |
---|---|
jira.attachments.number.of.zip.entries | Configuring the number of files shown in the content of ZIP-format files on issues |
jira.clone.prefix | Configuring the cloned issue summary field prefix |
jira.date.picker.java.format | Configuring date picker formats |
jira.issue.actions.order | Changing the Default Order for Comments from Ascending to Descending |
jira.projectkey.pattern | Configuring Project Keys |
jira.table.cols.subtasks | Configuring sub-task fields displayed on parent issues |
jira.view.issue.links.sort.order | Configuring the order of linked issues displayed on the 'view issue' page |
There are a handful of other advanced configuration options (which are of little interest to most JIRA system administrators) whose default values can be customised in the jira-config.properties
file located in the JIRA Home Directory, which you may want to edit. For details, please see Advanced JIRA configuration.