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: ```xml gitbucket.home PATH_TO_DATADIR ```