Source

trac-ticketlinks / wiki-default / TracEnvironment

Full commit
= Trac Storage - The Environment =
Trac uses a directory structure and an embedded [http://www.sqlite.org/ SQLite] database as storage.

== Creating an Environment ==
A new Trac environment is created using [wiki:TracAdmin trac-admin], like:

{{{
$ trac-admin /path/to/projectenv initenv
}}}

[wiki:TracAdmin trac-admin] will ask you where your subversion repository is located and
where it can find the trac templates directory (the default value should work for a typical install).

'''Note:''' The web server user will require file system write permission to the environment
directory and all the files inside. '''Remember to set the appropriate permissions.''

The same applies for the subversion repository files (unless using the [http://svn.collab.net/repos/svn/trunk/notes/fsfs FSFS Subversion backend], something we highly recommend. 



== Directory Structure ==
{{{
 EnvDir
   |-- README
   |-- VERSION
   |-- attachments
   |   |-- ticket
   |   `-- wiki
   |-- conf
   |   `-- trac.ini
   |-- db
   |   `-- trac.db
   |-- log
   |   `-- trac.log
   |-- templates
   |   |-- site_css.cs
   |   |-- site_footer.cs
   |   `-- site_header.cs
   `-- wiki-macros
}}}

 * '''README''' - Brief description of the environment.
 * '''VERSION''' - Contains the environment version identifier.
 * '''attachments''' - All attached files go in here.
   * '''ticket''' - Ticket attachments.
   * '''wiki''' - Wiki attachments.
 * '''conf'''
   * '''trac.ini''' - Main configuration file. See TracIni.
 * '''db'''
   * '''trac.db''' - SQLite database.
 * '''templates''' - Custom (environment-specific) templates.
   * '''site_css.cs''' - Custom CSS stylesheet.
   * '''site_footer.cs''' - Custom footer.
   * '''site_header.cs''' - Custom header.
 * '''wiki-macros''' - Environment-specific WikiMacros.

----
See also: TracBackup, TracIni, TracGuide