| | 1 | = The Trac Configuration File = |
| | 2 | [[TracGuideToc]] |
| | 3 | |
| | 4 | Trac configuration is done by editing the '''`trac.ini`''' config file, located in `<projectenv>/conf/trac.ini`. Changes to the configuration are usually reflected immediately, though changes to the `[components]` or `[logging]` sections will require restarting the web server. |
| | 5 | |
| | 6 | == Global Configuration == |
| | 7 | |
| | 8 | Since version 0.9 a global `trac.ini` file has to be explicitely specified in trac.ini. The global options in there will then be merged with the environment-specific options, where local options override global options. |
| | 9 | |
| | 10 | Since version 0.11 you must explicitly note which file to inherit from: |
| | 11 | {{{ |
| | 12 | [inherit] |
| | 13 | file = /usr/share/trac/conf/trac.ini |
| | 14 | }}} |
| | 15 | |
| | 16 | == Reference == |
| | 17 | |
| | 18 | This is a brief reference of available configuration options. |
| | 19 | |
| | 20 | [[TracIni]] |
| | 21 | |
| | 22 | == [components] == |
| | 23 | This section is used to enable or disable components provided by plugins, as well as by Trac itself. The component to enable/disable is specified via the name of the option. Whether its enabled is determined by the option value; setting the value to `enabled` or `on` will enable the component, any other value (typically `disabled` or `off`) will disable the component. |
| | 24 | |
| | 25 | The option name is either the fully qualified name of the components or the module/package prefix of the component. The former enables/disables a specific component, while the latter enables/disables any component in the specified package/module. |
| | 26 | |
| | 27 | Consider the following configuration snippet: |
| | 28 | {{{ |
| | 29 | [components] |
| | 30 | trac.ticket.report.ReportModule = disabled |
| | 31 | webadmin.* = enabled |
| | 32 | }}} |
| | 33 | |
| | 34 | The first option tells Trac to disable the [wiki:TracReports report module]. The second option instructs Trac to enable all components in the `webadmin` package. Note that the trailing wildcard is required for module/package matching. |
| | 35 | |
| | 36 | See the ''Plugins'' page on ''About Trac'' to get the list of active components (requires `CONFIG_VIEW` [wiki:TracPermissions permissions].) |
| | 37 | |
| | 38 | See also: TracPlugins |
| | 39 | |
| | 40 | == [ticket-custom] == |
| | 41 | |
| | 42 | In this section, you can define additional fields for tickets. See TracTicketsCustomFields for more details. |
| | 43 | |
| | 44 | ---- |
| | 45 | See also: TracGuide, TracAdmin, TracEnvironment |
