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.
[trac]
| database | Database connection string for this project
|
| default_charset | Charset used in text files in the subversion repository (default is iso-8859-15)
|
| default_handler | Name of the component that handles requests to the base URL (default is WikiHandler) (since 0.9)
|
| repository_dir | Path to local Subversion repository
|
| authz_file | Path to Subversion authorization (authz) file.
|
| check_auth_ip | Whether the IP address of the user should be checked for authentication (true, false) (since 0.9)
|
| ignore_auth_case | Whether case should be ignored for login names (true, false) (since 0.9)
|
| templates_dir | Path to the ClearSilver templates
|
[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)
|
| 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
|
[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
[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 | Username for SMTP server (since 0.9)
|
| smtp_password | Password for SMTP server (since 0.9)
|
| 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 | Always send notifications to the ticket owner (since 0.9)
|
See also: TracNotification
[mimeviewer]
| enscript_path | Path to the Enscript program
|
| php_path | Path to the PHP program
|
| max_preview_size | Maximum file size for HTML preview (since 0.9)
|
| tab_width | Displayed tab width in file preview (since 0.9)
|
[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 | Make the owner field of tickets use a drop-down menu (since 0.9)
|
[ticket-custom]
Creates user-defined ticket fields.
See TracTicketsCustomFields.
[timeline]
| changeset_show_files | Number of files to show (-1 for unlimited, 0 to disable)
|
| default_daysback | Default "depth" of the Timeline, in days (since 0.9)
|
[browser]
| hide_properties | List of subversion properties to hide from the repository browser (since 0.9)
|
[wiki]
| ignore_missing_pages | enable/disable highlighting CamelCase links to missing pages (since 0.9)
|
[disabled_components]
You can disable any Trac component by listing its name in this section and assigning a truth value (e.g. yes). See the Plugins page on About Trac to get the list of active components.
(since 0.9)
See also: TracGuide, TracAdmin, TracEnvironment
