Edgewall Software

Version 34 (modified by Matthew Good, 16 years ago) ( diff )

please be sure to note when the mentioned features are pre-release

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) (optional) user name for authentication SMTP account
smtp_password (requires 0.9) (optional) password for authentication SMTP account
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

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

[timeline]

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

[diff]

tab_width Displayed tab width in changeset diffs

[disabled_components]

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

[ticket-custom]

Creates user-defined ticket fields. See TracTicketsCustomFields.



See also: TracGuide, TracAdmin, TracTicketsCustomFields

Note: See TracWiki for help on using the wiki.