GitBucket/doc/directory.md

Directory Structure

GitBucket persists all data into HOME/.gitbucket in default (In 1.9 or before, HOME/gitbucket is default).

This directory has following structure:

* /HOME/.gitbucket
  * gitbucket.conf
  * database.conf
  * activity.log
  * data.mv.db, data.trace.db (H2 data files if the default embed H2 is used)
  * /repositories 
    * /USER_NAME
      * /REPO_NAME.git (substance of repository. GitServlet sees this directory)
      * /REPO_NAME.wiki.git (wiki repository)
      * /REPO_NAME
        * /issues (files attached to issue)
        * /lfs (LFS managed files)
  * /data
    * /USER_NAME
      * /files
        * avatar.xxx (image file of user avatar)
  * /plugins
    * plugin.jar
    * /.installed (copied available plugins from the parent directory automatically)
  * /sessions
    * HTTP session data created (if '--save_sessions' option is used in the standalone mode)
  * /tmp
    * /_upload
      * /SESSION_ID (removed at session timeout)
        * current time millis + random 10 alphanumeric chars (temporary file for file uploading)
    * /USER_NAME
      * /init-REPO_NAME (used in repository creation and removed after it) ... unused since 1.8
      * /REPO_NAME.wiki (working directory for wiki repository) ... unused since 1.8
      * /REPO_NAME
         * /download (temporary directories are created under this directory)

There are some ways to specify the data directory instead of the default location.

1. Environment variable GITBUCKET_HOME
2. System property gitbucket.home (e.g. -Dgitbucket.home=PATH_TO_DATADIR)
3. Command line option for embedded Jetty (e.g. java -jar gitbucket.war --data=PATH_TO_DATADIR)
4. Context parameter gitbucket.home in web.xml like below:

<context-param>
  <param-name>gitbucket.home</param-name>
  <param-value>PATH_TO_DATADIR</param-value>
</context-param>