= The Trac Configuration File =
[[TracGuideToc]]

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.

== Global Configuration ==

Global options will be merged with the environment-specific options, where local options override global options. The options file is specified as follows:
{{{
[inherit]
file = /usr/share/trac/conf/trac.ini
}}}

''Note : to use a global option file when creating a new project, add option `--inherit=/path/to/global/options` to `trac-admin initenv` command.

== Reference ==

This is a brief reference of available configuration options.

[[TracIni]]

== [components] ==
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.

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.

Consider the following configuration snippet:
{{{
[components]
trac.ticket.report.ReportModule = disabled
webadmin.* = enabled
}}}

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.

See the ''Plugins'' page on ''About Trac'' to get the list of active components (requires `CONFIG_VIEW` [wiki:TracPermissions permissions].)

See also: TracPlugins

== [ticket-custom] ==

In this section, you can define additional fields for tickets. See TracTicketsCustomFields for more details.

== [mainnav] [metanav] ==
The new [mainnav] and [metanav] can now be used to customize the text and link used for the navigation items, or even to disable them.

In the following example, we rename the link to the Wiki start "Home", and hide the "Help/Guide". We also make the "View Tickets" entry link to a specific report .
{{{
[mainnav]
wiki.label = Home
tickets.href = /report/24

[metanav]
help = disabled
}}}

----
See also: TracGuide, TracAdmin, TracEnvironment