Trac Storage - The Environment

Trac uses a directory structure and an embedded SQLite database as storage.

Creating an Environment

A new Trac environment is created using trac-admin, like: 

$ trac-admin /path/to/projectenv initenv

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 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