Objects per page options
Here you can configure the fixed values which users can select for the amount of objects (issues, commits etc.) which are displayed per page.
Search results per page
The number of search results which are displayed per page.
Days displayed on project activity
The initial (and recurring while browsing) amount of days of which the project(s)-activity is shown in the activity-tab.
Host name and path
Host name and path of your Redmine server. This name is used to write URL in emails sent to users. i.e.: the hostname of this precise Redmine is redmine.org.
Protocol used to generate links in email notifications. Default: http
Formatting method applied to the “description” fields of the issues, news, documents…
Cache formatted text (1.0)
Text formatting transforms raw text to HTML and runs each time a formatted text is sent to a user’s browser (eg. issue description, wiki page…), and this process can be slow with large pages or texts.
This setting lets you enable caching of formatted text.
The storage to be used to store cached data depends on the configuration of a cache store. The default cache store is FileStore. It stores cached data as files in
Wiki history compression
Maximum number of items in Atom feeds
This option lets you choose a custom theme.
Redmine is shipped with two additional themes besides the default theme:
- alternate, which mainly provides issue list colorization based on issues priority.
- classic, which is derived from the Redmine 0.5.1 design and brings a classic look.
Screenshot of the alternate theme:
Themes are located in
public/themes/. You can read more about Themes.
Force default language for anonymous users
Disables automatic language detection based on browser setting and force default language for anonymous users.
Force default language for logged-in users
Start calendars on
Lets you choose the first day of the week.
Lets you choose how dates are displayed:
- Based on user’s language: dates will be displayed specifically for each user, according to the format defined for its language
- Other formats: dates will always be displayed using the specified format
Lets you choose how times are displayed:
- Based on user’s language: times will be displayed specifically for each user, according to the format defined for its language
- Other formats: times will always be displayed using the specified format
Time span format
Let you choose the display format of timespans (estimated time, spent time, etc).
- 0.75 (default) : Displays in decimal.
- 0:45 h : Displays in “HH:MM” format.
Users display format
Lets you choose how usernames are displayed. The following combinations are provided:
- Firstname Surname
- Surname Firstname
- Surname, Firstname
Use Gravatar user icons
If enabled, users Gravatars (globally recognized avatar) will be displayed in several places.
Default Gravatar image
Display attachment thumbnails
The size of thumbnail images in pixels when “Display attachment thumbnails” is enabled.
Project menu tab for creating new objects
Let you choose the type of the tab for creating new objects.
- none: does not display either “New issue” tab or “+” drop-down.
- Display the “New issue” tab: displays “New issue” tab that was displayed in Redmine 3.2 and earlier.
- Display the “+” drop-down (default): displays “+” drop-down that can be used to create various objects such as issue, wiki page and so on.
This option lets you enable/disable new users self-registration:
- disabled: users are not allowed to register
- account activation by email: new users receive an email containing a link used to activate their accounts (users must provide a valid email address).
- manual account activation (default): new users’ accounts are created but need administrator approval. Administrators receive an email informing them that an account is pending their approval.
- automatic account activation: new users can log in as soon as they have registered.
See Register for further details about self-registration.
Allow users to delete their own account
If enabled, users can delete their account by clicking “Delete my account” link placed in the sidebar on “My account” page.
Minimum password length
Let’s the admin decide on the minimum length of the chosen passwords.
Require password change after
If this option is checked, lost password functionality is available. Default: Yes
Allow OpenID login and registration
Session maximum lifetime: Lets the administrator set the maximum lifetime of the session
Session inactivity timeout: Lets the administrator specify after how many hours of inactivity the session times out.
Warning 1: Changing these settings may expire the current sessions (including your own).
Warning 2: Redmine uses the rails cookiestore for session management. We strongly advise you to set a maximum session lifetime. If you don’t, it is theoretically possible that an attacker steals the session cookie and re-uses it.
New projects are public by default
Generate sequential project identifiers
Role given to a non-admin user who creates a project
Defines which role is given by default to a non-admin user who creates a project (this only applies when you have configured Redmine permissions in such a way that non-admin users are actually privileged to create projects).
Allow cross-project issue relations
Allow cross-project subtasks
Define some limits for subtasking. Definitions used are the same as version sharing, documented in RedmineProjectSettings. Default: With project treeOptions are:
disabled: a parent task can only have subtasks in the same project.
With all projects: a parent task can have subtasks in any other project.
With project tree: a parent task can have subtasks in the same project, ancestor projects and all their descendants (e.g. also “sibling projects”, “cousin projects”, etc.).
With project hierarchy: a parent task can have subtasks in the same project, subprojects, or ancestor projects.
With subprojects: a parent task can only have subtasks in the same project or subprojects (not in parent projects or unrelated projects).
Display subprojects issues on main projects by default
If set to true, subprojects issues will be displayed by default on the issue list, calendar and gantt of the main projects. Default: Yes
Calculate the issue done ratio
Defines how the Issue Done Percentage is set.
- Use the issue field (default): Users can manually set % done.
- Use the issue status: Each issue status can be assigned a percentage. This enables the “% Done” option for issues and the “Update issue done ratios” command in the issue statuses overview.
Issues export limit
Default columns displayed on the issue list
Attachment max. size
Max size of text files displayed inline KB
Max number of diff lines displayed
This option lets you specify preferred encodings for repository files (multiple values allowed, comma separated). These encodings are used to convert files content and diff to UTF-8 so that they’re properly displayed in the browser.
When entering multiple encodings, the first valid encoding regarding the file content is used.
For French users, this option can be for example set to:
UTF-8, ISO 8859-15, CP1252
For Japanese users:
UTF-8, CP932, EUC-JP
Emission mail address
Blind carbon copy recipients (bcc)
Plain text mail
See for detailed instructions about these settings RedmineReceivingEmails.
Truncate emails after one of these lines
Enable WS for incoming emails
Fetch commits automatically
If this option is activated, the application automatically retrieves the new revisions when a user consults the repository.
You can disable this option and automate the call to Repository#fetch_changesets using cron to regularly retrieve the revisions for all of the repositories in the background.
Enable WS for repository management
Repository management WS API key
Maximum number of revisions displayed on file log
Referencing issues in commit messages
When fetched from the repositories, commit messages are scanned for referenced or fixed issue IDs.
These options lets you define keywords that can be used in commit message to reference or fix issues automatically, and the status to apply to fixed issues.
Default keywords are:
- for referencing issues: refs, references, IssueID
- for fixing issues: fixes, closes
There’s no default status defined for fixed issue. You’ll have to specify it if you want to enable auto closure of issues.
If you want to reference issues without using keywords, enter a single star: * in the Referencing keywords (Administration/Repository) setting. In this case, any issue ID found in the message will be linked to the changeset.
Example of a working commit message using default keywords:
This message would reference issues 1 and 2 and automatically fix issue 3.
After a keyword issue IDs can be separated with a space, a comma or &.
The keywords are caseinsensitive and at least one blankspace or colon is needed between the keyword and the first hash to produce
a match. More examples that will produce the same result as the example above:
Enable time logging
Allows time logging directly from commit messages. This only makes sense if you activated the “Time tracking” module in said project. In this case, you can add special words in your commit message to indicate the time you spent on an issue.
The basic syntax for doing that is :
@<time>, where time consists in a number of hours or minutes.
Activity for logged time
This is the type of activity that should be used when detecting there’s a log time in a commit message (see above).