This page documents the 1.4 (latest stable) release. Documentation for other releases can be found here.

trac.ini Reference

Trac configuration is done by editing the trac.ini config file, located in <projectenv>/conf/trac.ini.

This is a brief reference of available configuration options.

[project]

name	Project name
descr	Short project description
url	URL to the main project website
icon	URL to icon file to use as shortcut icon (favicon)
footer	Page footer text (right-aligned)

[trac]

repository_dir	Path to local Subversion repository
authz_file	Path to authz_svn file. More info: FineGrainedPermissions
htdocs_location	Base URL for static Trac graphics and CSS files
database	Database to use for this project
templates_dir	Path to the ClearSilver templates
default_charset	Charset used in text files in the subversion repository (default is iso-8859-15)

[logging]

log_type	Logging facility to use. (none, file, stderr, syslog, winlog)
log_file	If log_type is file, this should be a path to the log-file
log_level	Level of verbosity in log (CRITICAL, ERROR, WARN, INFO, DEBUG)

See also: TracLogging

[ticket]

default_version	Default version for newly created tickets
default_severity	Default severity for newly created tickets
default_priority	Default priority for newly created tickets
default_milestone	Default milestone for newly created tickets
default_component	Default component for newly created tickets
restrict_owner	Optionally allow the owner field of tickets to use a drop-down menu (<select>)

See also: TracTicketsCustomFields

[attachment]

max_size

Maximum allowed file size for ticket and wiki attachments

[notification]

smtp_enabled	Enable SMTP (email) notification (true, false)
smtp_server	SMTP server to use for email notifications
smtp_user	(requires 0.9) Username for SMTP server
smtp_password	(requires 0.9) Password for SMTP server
smtp_from	Sender address to use in notification emails
smtp_replyto	Reply-To address to use in notification emails
smtp_always_cc	Email address(es) to always send notifications to
always_notify_reporter	Always send notifications to any address in the reporter field
always_notify_owner	(requires 0.9) Always send notifications to the ticketowner

See also: TracNotification

[header_logo]

src	URL to image to use as header logo
link	Destination URL to link to from header logo
alt	alt text for header logo
width	Header logo width in pixels
height	Header logo height in pixels

[mimeviewer]

enscript_path	Path to Enscript program
php_path	Path to PHP program
max_preview_size	Maximum file size for html preview (requires 0.9)

[timeline]

changeset_show_files	Number of files to show (-1 for unlimited, 0 to disable)
default_daysback	(requires 0.9) Default "depth" of the Timeline, in days

[diff]

tab_width

Displayed tab width in changeset diffs

[wiki]

ignore_missing_pages

(requires 0.9) enable/disable not highlighting CamelCase links

[disabled_components]

trac.ticket.web_ui.UpdateDetailsForTimeline	(requires 0.9) enable/disable showing ticket update details in the timeline ( [1594] )
trac.mimeview.php	(requires 0.9) enable/disable php highlighting by php itself

With the new TracPluggableModules, it is possible to disable some components, by listing them in this section and giving them a truth value (e.g. yes).

[ticket-custom]

Creates user-defined ticket fields. See TracTicketsCustomFields.

---

See also: TracGuide, TracAdmin, TracTicketsCustomFields