Application settings

Reference for all categories in the Redmine Administration Settings panel.

Application settings are managed at Administration → Settings. Changes take effect immediately without restarting the server. Settings are stored in the database and cached per request.

Editing settings requires administrator access. Some security-sensitive settings also require re-entering your password (sudo mode) before saving.

General

Setting	Default	Description
app_title	Redmine	Application name shown in the browser title and navigation.
welcome_text	(see below)	HTML/text displayed on the application home page.
host_name	localhost:3000	Hostname and port used to generate absolute URLs in emails and feeds.
protocol	http	Protocol (http or https) used to generate absolute URLs.
text_formatting	common_mark	Default text formatter used for descriptions and wiki pages.
default_language	en	Default language for new users and the application interface.
force_default_language_for_anonymous	0	Force anonymous users to use default_language.
force_default_language_for_loggedin	0	Force logged-in users to use default_language.
attachment_max_size	5120 (KB)	Maximum size of a single file upload in kilobytes.
bulk_download_max_size	102400 (KB)	Maximum total size for bulk file downloads.

Display

Setting	Default	Description
date_format	(locale default)	Date display format. Supports strftime tokens such as %Y-%m-%d.
time_format	(locale default)	Time display format (%H:%M or %I:%M %p).
user_format	firstname_lastname	How user names are displayed throughout the application.
per_page_options	25,50,100	Comma-separated list of items-per-page options in list views.
activity_days_default	10	Number of days shown by default on the Activity page.
feeds_limit	15	Maximum number of items returned in Atom feeds.
gantt_items_limit	500	Maximum issues shown in a Gantt chart.
gantt_months_limit	24	Maximum months visible in a Gantt chart.
display_subprojects_issues	1	Show issues from subprojects in parent project lists.

Authentication

Setting	Default	Description
login_required	0	Require login to access the application.
autologin	0	Number of days the autologin cookie is valid. 0 disables autologin.
self_registration	2	Controls user self-registration: 0 = disabled, 1 = account activation by email, 2 = automatic activation, 3 = manual activation by administrator.
lost_password	1	Allow users to reset their password via email.
password_min_length	8	Minimum number of characters required for passwords.
password_max_age	0	Password expiry in days. 0 disables expiry.
session_lifetime	0	Maximum session duration in minutes. 0 means no limit.
session_timeout	0	Session idle timeout in minutes. 0 means no timeout.
twofa	1	Two-factor authentication: 0 = disabled, 1 = optional for all users, 2 = required for all users, 3 = required for administrators only.

See Authentication options for more detail on each method.

API

Setting	Default	Description
rest_api_enabled	0	Enable the REST web service API. Must be set to 1 before any API calls will work.
jsonp_enabled	0	Enable JSONP support for the REST API (cross-domain browser requests).
webhooks_enabled	0	Enable outgoing webhooks for Redmine events.
sys_api_enabled	0	Enable the internal repository management API (used by reposman.rb).
sys_api_key	(empty)	API key required for repository management requests.
mail_handler_api_enabled	0	Enable the inbound email API endpoint.
mail_handler_api_key	(empty)	API key for the inbound email endpoint.

The REST API is disabled by default. Go to Administration → Settings → API and enable Enable REST web service before making any API calls.

Email notifications

Setting	Default	Description
mail_from	[e-mail]	From address used in outgoing emails.
plain_text_mail	0	Send plain-text emails instead of HTML.
notified_events	issue_added, issue_updated	Events that trigger email notifications.

Outgoing email delivery is configured in config/configuration.yml, not in the Settings panel. See Email configuration.

Incoming emails

Setting	Default	Description
mail_handler_body_delimiters	(empty)	Text patterns that mark the end of the email body. Content after these delimiters is discarded.
mail_handler_enable_regex_delimiters	0	Treat body delimiters as regular expressions.
mail_handler_excluded_filenames	(empty)	Comma-separated list of attachment filenames to ignore.
mail_handler_preferred_body_part	plain	Preferred MIME part when both text/plain and text/html are present.

Repositories

Setting	Default	Description
enabled_scm	Subversion, Mercurial, Cvs, Bazaar, Git	SCM types available when creating a repository in project settings.
autofetch_changesets	1	Automatically fetch new commits when the repository is browsed.
commit_ref_keywords	refs,references,IssueID	Commit message keywords that create a reference to an issue.
commit_update_keywords	(empty)	Rules that update issue fields when a matching keyword appears in a commit message.
commit_logtime_enabled	0	Log time automatically from commit messages.
commit_cross_project_ref	0	Allow commits to reference issues in other projects.

See Repositories for full configuration details.

Files

Setting	Default	Description
attachment_extensions_allowed	(empty)	Comma-separated list of allowed file extensions. Empty means all extensions are allowed.
attachment_extensions_denied	(empty)	Comma-separated list of blocked file extensions.
max_additional_emails	5	Maximum number of additional email addresses a user can add to their account.