Configuring JIRA

PDF
PDF

JIRA has a number of configuration options which can alter the way it operates, better customising the application for your development team.

The current configuration can be viewed via the Administration interface. It should look like this:

Screenshot of JIRA configuration settings and options

Clicking Edit Configuration will allow you to edit the current configuration.

Here is a list of the different configuration options available, and what they do.

Settings

SettingDescription
Title This is the title that will be shown to users logging into JIRA. It helps identify your installation and its purpose.
Base URL

This is the base URL of this Atlassian installation.

It is used in outgoing emails and notifications to construct valid links.

Mode

JIRA can operate in two modes:

public The default operation mode for JIRA. Anyone can sign themselves up and create issues.
private Useful for internal issue tracking systems where you do not want public users to login. Signup is disabled, only Administrators can create new users.
Attachment Path

The absolute or relative path to the directory under which all attachments will be stored.

Note
When changing this path you will have to manually copy any existing attachments across to the new directory.
Introduction

A short introduction message displayed on the dashboard. You can include HTML, but make sure to close all your tags.

Character Encoding

The character encoding for input and viewing of information. For most western languages, the default ("UTF-8") is suitable.

If you change this setting - ensure that you also change your database's encoding.

View a list of supported encodings. However, please use the IANA preferred MIME name (such as 'iso-8859-1' instead of 'ISO8859_1') to ensure XML backups have the correct encoding string.

Options

Allow users to vote on issues

This controls whether or not users can vote for issues they want fixed.

Default: ON

Allow users to watch issues

Controls whether or not users can 'watch' issues that they are interested in. Users watching an issue will be notified of all changes to it.

Default: ON

Allow Attachments

Controls if attachments are allowed. If turned on, you must enter an attachment path above.

Default: OFF

Allow unassigned issues

When turned on, JIRA will allow issues to be unassigned.

When turned off, issues will always be assigned to someone - when created this is by default the lead project developer.

Default: OFF

Allow assigning issues to new users

When turned on, JIRA will allow issues to be assigned to an email address, a new developer will be created automatically and a password emailed to the user.

When turned off, issues can only be assigned to existing developers.

Default: OFF

Proactively cache projects / versions / components

When turned on, JIRA will cache projects, versions & components.

As of JIRA 3.3 this caching is no longer needed, and should be turned off to save memory.

Default: OFF

External User Management

When turned on, JIRA will assume that users are managed externally - hence users cannot change their password or details from within JIRA.

Note that JIRA's LDAP integration is currently limited to external password management, so this flag should be left OFF when using LDAP.

Default: OFF

Advanced properties

There are a handful of other properties (usually storing defaults of little interest to most JIRA users) in the WEB-INF/classes/jira-application.properties file, which you may want to edit.