#
|
# Git Servlet Settings
|
#
|
|
# Base folder for repositories.
|
# This folder may contain bare and non-bare repositories but Gitblit will only
|
# allow you to push to bare repositories.
|
# Use forward slashes even on Windows!!
|
# e.g. c:/gitrepos
|
#
|
# SINCE 0.5.0
|
# RESTART REQUIRED
|
git.repositoriesFolder = ${baseFolder}/git
|
|
# Build the available repository list at startup and cache this list for reuse.
|
# This reduces disk io when presenting the repositories page, responding to rpcs,
|
# etc, but it means that Gitblit will not automatically identify repositories
|
# added or deleted by external tools.
|
#
|
# For this case you can use curl, wget, etc to issue an rpc request to clear the
|
# cache (e.g. https://localhost/rpc?req=CLEAR_REPOSITORY_CACHE)
|
#
|
# SINCE 1.1.0
|
git.cacheRepositoryList = true
|
|
# Search the repositories folder subfolders for other repositories.
|
# Repositories MAY NOT be nested (i.e. one repository within another)
|
# but they may be grouped together in subfolders.
|
# e.g. c:/gitrepos/libraries/mylibrary.git
|
# c:/gitrepos/libraries/myotherlibrary.git
|
#
|
# SINCE 0.5.0
|
git.searchRepositoriesSubfolders = true
|
|
# Maximum number of folders to recurse into when searching for repositories.
|
# The default value, -1, disables depth limits.
|
#
|
# SINCE 1.1.0
|
git.searchRecursionDepth = -1
|
|
# List of regex exclusion patterns to match against folders found in
|
# *git.repositoriesFolder*.
|
# Use forward slashes even on Windows!!
|
# e.g. test/jgit\.git
|
#
|
# SPACE-DELIMITED
|
# CASE-SENSITIVE
|
# SINCE 1.1.0
|
git.searchExclusions =
|
|
# List of regex url patterns for extracting a repository name when locating
|
# submodules.
|
# e.g. git.submoduleUrlPatterns = .*?://github.com/(.*) will extract
|
# *gitblit/gitblit.git* from *git://github.com/gitblit/gitblit.git*
|
# If no matches are found then the submodule repository name is assumed to be
|
# whatever trails the last / character. (e.g. gitblit.git).
|
#
|
# SPACE-DELIMITED
|
# CASE-SENSITIVE
|
# SINCE 1.1.0
|
git.submoduleUrlPatterns = .*?://github.com/(.*)
|
|
# Allow push/pull over http/https with JGit servlet.
|
# If you do NOT want to allow Git clients to clone/push to Gitblit set this
|
# to false. You might want to do this if you are only using ssh:// or git://.
|
# If you set this false, consider changing the *web.otherUrls* setting to
|
# indicate your clone/push urls.
|
#
|
# SINCE 0.5.0
|
git.enableGitServlet = true
|
|
# If you want to restrict all git servlet access to those with valid X509 client
|
# certificates then set this value to true.
|
#
|
# SINCE 1.2.0
|
git.requiresClientCertificate = false
|
|
# Enforce date checks on client certificates to ensure that they are not being
|
# used prematurely and that they have not expired.
|
#
|
# SINCE 1.2.0
|
git.enforceCertificateValidity = true
|
|
# List of OIDs to extract from a client certificate DN to map a certificate to
|
# an account username.
|
#
|
# e.g. git.certificateUsernameOIDs = CN
|
# e.g. git.certificateUsernameOIDs = FirstName LastName
|
#
|
# SPACE-DELIMITED
|
# SINCE 1.2.0
|
git.certificateUsernameOIDs = CN
|
|
# Only serve/display bare repositories.
|
# If there are non-bare repositories in git.repositoriesFolder and this setting
|
# is true, they will be excluded from the ui.
|
#
|
# SINCE 0.9.0
|
git.onlyAccessBareRepositories = false
|
|
# Allow an authenticated user to create a destination repository on a push if
|
# the repository does not already exist.
|
#
|
# Administrator accounts can create a repository in any project.
|
# These repositories are created with the default access restriction and authorization
|
# control values. The pushing account is set as the owner.
|
#
|
# Non-administrator accounts with the CREATE role may create personal repositories.
|
# These repositories are created as VIEW restricted for NAMED users.
|
# The pushing account is set as the owner.
|
#
|
# SINCE 1.2.0
|
git.allowCreateOnPush = true
|
|
# The default access restriction for new repositories.
|
# Valid values are NONE, PUSH, CLONE, VIEW
|
# NONE = anonymous view, clone, & push
|
# PUSH = anonymous view & clone and authenticated push
|
# CLONE = anonymous view, authenticated clone & push
|
# VIEW = authenticated view, clone, & push
|
#
|
# SINCE 1.0.0
|
git.defaultAccessRestriction = NONE
|
|
# The default authorization control for new repositories.
|
# Valid values are AUTHENTICATED and NAMED
|
# AUTHENTICATED = any authenticated user is granted restricted access
|
# NAMED = only named users/teams are granted restricted access
|
#
|
# SINCE 1.1.0
|
git.defaultAuthorizationControl = NAMED
|
|
# Enable JGit-based garbage collection. (!!EXPERIMENTAL!!)
|
#
|
# USE AT YOUR OWN RISK!
|
#
|
# If enabled, the garbage collection executor scans all repositories once a day
|
# at the hour of your choosing. The GC executor will take each repository "offline",
|
# one-at-a-time, to check if the repository satisfies it's GC trigger requirements.
|
#
|
# While the repository is offline it will be inaccessible from the web UI or from
|
# any of the other services (git, rpc, rss, etc).
|
#
|
# Gitblit's GC Executor MAY NOT PLAY NICE with the other Git kids on the block,
|
# especially on Windows systems, so if you are using other tools please coordinate
|
# their usage with your GC Executor schedule or do not use this feature.
|
#
|
# The GC algorithm complex and the JGit team advises caution when using their
|
# young implementation of GC.
|
#
|
# http://wiki.eclipse.org/EGit/New_and_Noteworthy/2.1#Garbage_Collector_and_Repository_Storage_Statistics
|
#
|
# EXPERIMENTAL
|
# SINCE 1.2.0
|
# RESTART REQUIRED
|
git.enableGarbageCollection = false
|
|
# Hour of the day for the GC Executor to scan repositories.
|
# This value is in 24-hour time.
|
#
|
# SINCE 1.2.0
|
git.garbageCollectionHour = 0
|
|
# The default minimum total filesize of loose objects to trigger early garbage
|
# collection.
|
#
|
# You may specify a custom threshold for a repository in the repository's settings.
|
# Common unit suffixes of k, m, or g are supported.
|
#
|
# SINCE 1.2.0
|
git.defaultGarbageCollectionThreshold = 500k
|
|
# The default period, in days, between GCs for a repository. If the total filesize
|
# of the loose object exceeds *git.garbageCollectionThreshold* or the repository's
|
# custom threshold, this period will be short-circuited.
|
#
|
# e.g. if a repository collects 100KB of loose objects every day with a 500KB
|
# threshold and a period of 7 days, it will take 5 days for the loose objects to
|
# be collected, packed, and pruned.
|
#
|
# OR
|
#
|
# if a repository collects 10KB of loose objects every day with a 500KB threshold
|
# and a period of 7 days, it will take the full 7 days for the loose objects to be
|
# collected, packed, and pruned.
|
#
|
# You may specify a custom period for a repository in the repository's settings.
|
#
|
# The minimum value is 1 day since the GC Executor only runs once a day.
|
#
|
# SINCE 1.2.0
|
git.defaultGarbageCollectionPeriod = 7
|
|
# Number of bytes of a pack file to load into memory in a single read operation.
|
# This is the "page size" of the JGit buffer cache, used for all pack access
|
# operations. All disk IO occurs as single window reads. Setting this too large
|
# may cause the process to load more data than is required; setting this too small
|
# may increase the frequency of read() system calls.
|
#
|
# Default on JGit is 8 KiB on all platforms.
|
#
|
# Common unit suffixes of k, m, or g are supported.
|
# Documentation courtesy of the Gerrit project.
|
#
|
# SINCE 1.0.0
|
# RESTART REQUIRED
|
git.packedGitWindowSize = 8k
|
|
# Maximum number of bytes to load and cache in memory from pack files. If JGit
|
# needs to access more than this many bytes it will unload less frequently used
|
# windows to reclaim memory space within the process. As this buffer must be shared
|
# with the rest of the JVM heap, it should be a fraction of the total memory available.
|
#
|
# The JGit team recommends setting this value larger than the size of your biggest
|
# repository. This ensures you can serve most requests from memory.
|
#
|
# Default on JGit is 10 MiB on all platforms.
|
#
|
# Common unit suffixes of k, m, or g are supported.
|
# Documentation courtesy of the Gerrit project.
|
#
|
# SINCE 1.0.0
|
# RESTART REQUIRED
|
git.packedGitLimit = 10m
|
|
# Maximum number of bytes to reserve for caching base objects that multiple deltafied
|
# objects reference. By storing the entire decompressed base object in a cache Git
|
# is able to avoid unpacking and decompressing frequently used base objects multiple times.
|
#
|
# Default on JGit is 10 MiB on all platforms. You probably do not need to adjust
|
# this value.
|
#
|
# Common unit suffixes of k, m, or g are supported.
|
# Documentation courtesy of the Gerrit project.
|
#
|
# SINCE 1.0.0
|
# RESTART REQUIRED
|
git.deltaBaseCacheLimit = 10m
|
|
# Maximum number of pack files to have open at once. A pack file must be opened
|
# in order for any of its data to be available in a cached window.
|
#
|
# If you increase this to a larger setting you may need to also adjust the ulimit
|
# on file descriptors for the host JVM, as Gitblit needs additional file descriptors
|
# available for network sockets and other repository data manipulation.
|
#
|
# Default on JGit is 128 file descriptors on all platforms.
|
# Documentation courtesy of the Gerrit project.
|
#
|
# SINCE 1.0.0
|
# RESTART REQUIRED
|
git.packedGitOpenFiles = 128
|
|
# Largest object size, in bytes, that JGit will allocate as a contiguous byte
|
# array. Any file revision larger than this threshold will have to be streamed,
|
# typically requiring the use of temporary files under $GIT_DIR/objects to implement
|
# psuedo-random access during delta decompression.
|
#
|
# Servers with very high traffic should set this to be larger than the size of
|
# their common big files. For example a server managing the Android platform
|
# typically has to deal with ~10-12 MiB XML files, so 15 m would be a reasonable
|
# setting in that environment. Setting this too high may cause the JVM to run out
|
# of heap space when handling very big binary files, such as device firmware or
|
# CD-ROM ISO images. Make sure to adjust your JVM heap accordingly.
|
#
|
# Default is 50 MiB on all platforms.
|
#
|
# Common unit suffixes of k, m, or g are supported.
|
# Documentation courtesy of the Gerrit project.
|
#
|
# SINCE 1.0.0
|
# RESTART REQUIRED
|
git.streamFileThreshold = 50m
|
|
# When true, JGit will use mmap() rather than malloc()+read() to load data from
|
# pack files. The use of mmap can be problematic on some JVMs as the garbage
|
# collector must deduce that a memory mapped segment is no longer in use before
|
# a call to munmap() can be made by the JVM native code.
|
#
|
# In server applications (such as Gitblit) that need to access many pack files,
|
# setting this to true risks artificially running out of virtual address space,
|
# as the garbage collector cannot reclaim unused mapped spaces fast enough.
|
#
|
# Default on JGit is false. Although potentially slower, it yields much more
|
# predictable behavior.
|
# Documentation courtesy of the Gerrit project.
|
#
|
# SINCE 1.0.0
|
# RESTART REQUIRED
|
git.packedGitMmap = false
|
|
#
|
# Groovy Integration
|
#
|
|
# Location of Groovy scripts to use for Pre and Post receive hooks.
|
# Use forward slashes even on Windows!!
|
# e.g. c:/groovy
|
#
|
# RESTART REQUIRED
|
# SINCE 0.8.0
|
groovy.scriptsFolder = ${baseFolder}/groovy
|
|
# Specify the directory Grape uses for downloading libraries.
|
# http://groovy.codehaus.org/Grape
|
#
|
# RESTART REQUIRED
|
# SINCE 1.0.0
|
groovy.grapeFolder = ${baseFolder}/groovy/grape
|
|
# Scripts to execute on Pre-Receive.
|
#
|
# These scripts execute after an incoming push has been parsed and validated
|
# but BEFORE the changes are applied to the repository. You might reject a
|
# push in this script based on the repository and branch the push is attempting
|
# to change.
|
#
|
# Script names are case-sensitive on case-sensitive file systems. You may omit
|
# the traditional ".groovy" from this list if your file extension is ".groovy"
|
#
|
# NOTE:
|
# These scripts are only executed when pushing to *Gitblit*, not to other Git
|
# tooling you may be using. Also note that these scripts are shared between
|
# repositories. These are NOT repository-specific scripts! Within the script
|
# you may customize the control-flow for a specific repository by checking the
|
# *repository* variable.
|
#
|
# SPACE-DELIMITED
|
# CASE-SENSITIVE
|
# SINCE 0.8.0
|
groovy.preReceiveScripts =
|
|
# Scripts to execute on Post-Receive.
|
#
|
# These scripts execute AFTER an incoming push has been applied to a repository.
|
# You might trigger a continuous-integration build here or send a notification.
|
#
|
# Script names are case-sensitive on case-sensitive file systems. You may omit
|
# the traditional ".groovy" from this list if your file extension is ".groovy"
|
#
|
# NOTE:
|
# These scripts are only executed when pushing to *Gitblit*, not to other Git
|
# tooling you may be using. Also note that these scripts are shared between
|
# repositories. These are NOT repository-specific scripts! Within the script
|
# you may customize the control-flow for a specific repository by checking the
|
# *repository* variable.
|
#
|
# SPACE-DELIMITED
|
# CASE-SENSITIVE
|
# SINCE 0.8.0
|
groovy.postReceiveScripts =
|
|
# Repository custom fields for Groovy Hook mechanism
|
#
|
# List of key=label pairs of custom fields to prompt for in the Edit Repository
|
# page. These keys are stored in the repository's git config file in the
|
# section [gitblit "customFields"]. Key names are alphanumeric only. These
|
# fields are intended to be used for the Groovy hook mechanism where a script
|
# can adjust it's execution based on the custom fields stored in the repository
|
# config.
|
#
|
# e.g. "commitMsgRegex=Commit Message Regular Expression" anotherProperty=Another
|
#
|
# SPACE-DELIMITED
|
# SINCE 1.0.0
|
groovy.customFields =
|
|
#
|
# Authentication Settings
|
#
|
|
# Require authentication to see everything but the admin pages
|
#
|
# SINCE 0.5.0
|
# RESTART REQUIRED
|
web.authenticateViewPages = false
|
|
# Require admin authentication for the admin functions and pages
|
#
|
# SINCE 0.5.0
|
# RESTART REQUIRED
|
web.authenticateAdminPages = true
|
|
# Allow Gitblit to store a cookie in the user's browser for automatic
|
# authentication. The cookie is generated by the user service.
|
#
|
# SINCE 0.5.0
|
web.allowCookieAuthentication = true
|
|
# Config file for storing project metadata
|
#
|
# SINCE 1.2.0
|
web.projectsFile = ${baseFolder}/projects.conf
|
|
# Either the full path to a user config file (users.conf)
|
# OR the full path to a simple user properties file (users.properties)
|
# OR a fully qualified class name that implements the IUserService interface.
|
#
|
# Alternative user services:
|
# com.gitblit.LdapUserService
|
# com.gitblit.RedmineUserService
|
#
|
# Any custom user service implementation must have a public default constructor.
|
#
|
# SINCE 0.5.0
|
# RESTART REQUIRED
|
realm.userService = test-ui-users.conf
|
|
# How to store passwords.
|
# Valid values are plain, md5, or combined-md5. md5 is the hash of password.
|
# combined-md5 is the hash of username.toLowerCase()+password.
|
# Default is md5.
|
#
|
# SINCE 0.5.0
|
realm.passwordStorage = md5
|
|
# Minimum valid length for a plain text password.
|
# Default value is 5. Absolute minimum is 4.
|
#
|
# SINCE 0.5.0
|
realm.minPasswordLength = 5
|
|
#
|
# Gitblit Web Settings
|
#
|
# If blank Gitblit is displayed.
|
#
|
# SINCE 0.5.0
|
web.siteName =
|
|
# If *web.authenticateAdminPages*=true, users with "admin" role can create
|
# repositories, create users, and edit repository metadata.
|
#
|
# If *web.authenticateAdminPages*=false, any user can execute the aforementioned
|
# functions.
|
#
|
# SINCE 0.5.0
|
web.allowAdministration = true
|
|
# Allows rpc clients to list repositories and possibly manage or administer the
|
# Gitblit server, if the authenticated account has administrator permissions.
|
# See *web.enableRpcManagement* and *web.enableRpcAdministration*.
|
#
|
# SINCE 0.7.0
|
web.enableRpcServlet = true
|
|
# Allows rpc clients to manage repositories and users of the Gitblit instance,
|
# if the authenticated account has administrator permissions.
|
# Requires *web.enableRpcServlet=true*.
|
#
|
# SINCE 0.7.0
|
web.enableRpcManagement = false
|
|
# Allows rpc clients to control the server settings and monitor the health of this
|
# this Gitblit instance, if the authenticated account has administrator permissions.
|
# Requires *web.enableRpcServlet=true* and *web.enableRpcManagement*.
|
#
|
# SINCE 0.7.0
|
web.enableRpcAdministration = false
|
|
# Full path to a configurable robots.txt file. With this file you can control
|
# what parts of your Gitblit server respectable robots are allowed to traverse.
|
# http://googlewebmastercentral.blogspot.com/2008/06/improving-on-robots-exclusion-protocol.html
|
#
|
# SINCE 1.0.0
|
web.robots.txt =
|
|
# If true, the web ui layout will respond and adapt to the browser's dimensions.
|
# if false, the web ui will use a 940px fixed-width layout.
|
# http://twitter.github.com/bootstrap/scaffolding.html#responsive
|
#
|
# SINCE 1.0.0
|
web.useResponsiveLayout = true
|
|
# Allow Gravatar images to be displayed in Gitblit pages.
|
#
|
# SINCE 0.8.0
|
web.allowGravatar = true
|
|
# Allow dynamic zip downloads.
|
#
|
# SINCE 0.5.0
|
web.allowZipDownloads = true
|
|
# If *web.allowZipDownloads=true* the following formats will be displayed for
|
# download compressed archive links:
|
#
|
# zip = standard .zip
|
# tar = standard tar format (preserves *nix permissions and symlinks)
|
# gz = gz-compressed tar
|
# xz = xz-compressed tar
|
# bzip2 = bzip2-compressed tar
|
#
|
# SPACE-DELIMITED
|
# SINCE 1.2.0
|
web.compressedDownloads = zip gz
|
|
# Allow optional Lucene integration. Lucene indexing is an opt-in feature.
|
# A repository may specify branches to index with Lucene instead of using Git
|
# commit traversal. There are scenarios where you may want to completely disable
|
# Lucene indexing despite a repository specifying indexed branches. One such
|
# scenario is on a resource-constrained federated Gitblit mirror.
|
#
|
# SINCE 0.9.0
|
web.allowLuceneIndexing = false
|
|
# Allows an authenticated user to create forks of a repository
|
#
|
# set this to false if you want to disable all fork controls on the web site
|
#
|
web.allowForking = true
|
|
# Controls the length of shortened commit hash ids
|
#
|
# SINCE 1.2.0
|
web.shortCommitIdLength = 6
|
|
# Use Clippy (Flash solution) to provide a copy-to-clipboard button.
|
# If false, a button with a more primitive JavaScript-based prompt box will
|
# offer a 3-step (click, ctrl+c, enter) copy-to-clipboard alternative.
|
#
|
# SINCE 0.8.0
|
web.allowFlashCopyToClipboard = true
|
|
# Default maximum number of commits that a repository may contribute to the
|
# activity page, regardless of the selected duration. This setting may be valuable
|
# for an extremely busy server. This value may also be configed per-repository
|
# in Edit Repository. 0 disables this throttle.
|
#
|
# SINCE 1.2.0
|
web.maxActivityCommits = 0
|
|
# Default number of entries to include in RSS Syndication links
|
#
|
# SINCE 0.5.0
|
web.syndicationEntries = 25
|
|
# Show the size of each repository on the repositories page.
|
# This requires recursive traversal of each repository folder. This may be
|
# non-performant on some operating systems and/or filesystems.
|
#
|
# SINCE 0.5.2
|
web.showRepositorySizes = true
|
|
# List of custom regex expressions that can be displayed in the Filters menu
|
# of the Repositories and Activity pages. Keep them very simple because you
|
# are likely to run into encoding issues if they are too complex.
|
#
|
# Use !!! to separate the filters
|
#
|
# SINCE 0.8.0
|
web.customFilters =
|
|
# Show federation registrations (without token) and the current pull status
|
# to non-administrator users.
|
#
|
# SINCE 0.6.0
|
web.showFederationRegistrations = false
|
|
# This is the message displayed when *web.authenticateViewPages=true*.
|
# This can point to a file with Markdown content.
|
# Specifying "gitblit" uses the internal login message.
|
#
|
# SINCE 0.7.0
|
web.loginMessage = gitblit
|
|
# This is the message displayed above the repositories table.
|
# This can point to a file with Markdown content.
|
# Specifying "gitblit" uses the internal welcome message.
|
#
|
# SINCE 0.5.0
|
web.repositoriesMessage = gitblit
|
|
# Ordered list of charsets/encodings to use when trying to display a blob.
|
# If empty, UTF-8 and ISO-8859-1 are used. The server's default charset
|
# is always appended to the encoding list. If all encodings fail to cleanly
|
# decode the blob content, UTF-8 will be used with the standard malformed
|
# input/unmappable character replacement strings.
|
#
|
# SPACE-DELIMITED
|
# SINCE 1.0.0
|
web.blobEncodings = UTF-8 ISO-8859-1
|
|
# Manually set the default timezone to be used by Gitblit for display in the
|
# web ui. This value is independent of the JVM timezone. Specifying a blank
|
# value will default to the JVM timezone.
|
# e.g. America/New_York, US/Pacific, UTC, Europe/Berlin
|
#
|
# SINCE 0.9.0
|
# RESTART REQUIRED
|
web.timezone =
|
|
# Use the client timezone when formatting dates.
|
# This uses AJAX to determine the browser's timezone and may require more
|
# server overhead because a Wicket session is created. All Gitblit pages
|
# attempt to be stateless, if possible.
|
#
|
# SINCE 0.5.0
|
# RESTART REQUIRED
|
web.useClientTimezone = false
|
|
# Time format
|
# <http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html>
|
#
|
# SINCE 0.8.0
|
web.timeFormat = HH:mm
|
|
# Short date format
|
# <http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html>
|
#
|
# SINCE 0.5.0
|
web.datestampShortFormat = yyyy-MM-dd
|
|
# Long date format
|
#
|
# SINCE 0.8.0
|
web.datestampLongFormat = EEEE, MMMM d, yyyy
|
|
# Long timestamp format
|
# <http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html>
|
#
|
# SINCE 0.5.0
|
web.datetimestampLongFormat = EEEE, MMMM d, yyyy HH:mm Z
|
|
# Mount URL parameters
|
# This setting controls if pretty or parameter URLs are used.
|
# i.e.
|
# if true:
|
# http://localhost/commit/myrepo/abcdef
|
# if false:
|
# http://localhost/commit/?r=myrepo&h=abcdef
|
#
|
# SINCE 0.5.0
|
# RESTART REQUIRED
|
web.mountParameters = true
|
|
# Some servlet containers (e.g. Tomcat >= 6.0.10) disallow '/' (%2F) encoding
|
# in URLs as a security precaution for proxies. This setting tells Gitblit
|
# to preemptively replace '/' with '*' or '!' for url string parameters.
|
#
|
# <https://issues.apache.org/jira/browse/WICKET-1303>
|
# <http://tomcat.apache.org/security-6.html#Fixed_in_Apache_Tomcat_6.0.10>
|
# Add *-Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true* to your
|
# *CATALINA_OPTS* or to your JVM launch parameters
|
#
|
# SINCE 0.5.2
|
web.forwardSlashCharacter = /
|
|
# Show other URLs on the summary page for accessing your git repositories
|
# Use spaces to separate urls. {0} is the token for the repository name.
|
# e.g.
|
# web.otherUrls = ssh://localhost/git/{0} git://localhost/git/{0}
|
#
|
# SPACE-DELIMITED
|
# SINCE 0.5.0
|
web.otherUrls =
|
|
# Choose how to present the repositories list.
|
# grouped = group nested/subfolder repositories together (no sorting)
|
# flat = flat list of repositories (sorting allowed)
|
#
|
# SINCE 0.5.0
|
web.repositoryListType = grouped
|
|
# If using a grouped repository list and there are repositories at the
|
# root level of your repositories folder, you may specify the displayed
|
# group name with this setting. This value is only used for web presentation.
|
#
|
# SINCE 0.5.0
|
web.repositoryRootGroupName = main
|
|
# Display the repository swatch color next to the repository name link in the
|
# repositories list.
|
#
|
# SINCE 0.8.0
|
web.repositoryListSwatches = true
|
|
# Choose the diff presentation style: gitblt, gitweb, or plain
|
#
|
# SINCE 0.5.0
|
web.diffStyle = gitblit
|
|
# Control if email addresses are shown in web ui
|
#
|
# SINCE 0.5.0
|
web.showEmailAddresses = true
|
|
# Shows a combobox in the page links header with commit, committer, and author
|
# search selection. Default search is commit.
|
#
|
# SINCE 0.5.0
|
web.showSearchTypeSelection = false
|
|
# Generates a line graph of repository activity over time on the Summary page.
|
# This uses the Google Charts API.
|
#
|
# SINCE 0.5.0
|
web.generateActivityGraph = true
|
|
# The number of days to show on the activity page.
|
# Value must exceed 0 else default of 14 is used
|
#
|
# SINCE 0.8.0
|
web.activityDuration = 14
|
|
# The number of commits to display on the summary page
|
# Value must exceed 0 else default of 20 is used
|
#
|
# SINCE 0.5.0
|
web.summaryCommitCount = 16
|
|
# The number of tags/branches to display on the summary page.
|
# -1 = all tags/branches
|
# 0 = hide tags/branches
|
# N = N tags/branches
|
#
|
# SINCE 0.5.0
|
web.summaryRefsCount = 5
|
|
# The number of items to show on a page before showing the first, prev, next
|
# pagination links. A default if 50 is used for any invalid value.
|
#
|
# SINCE 0.5.0
|
web.itemsPerPage = 50
|
|
# Registered file extensions to ignore during Lucene indexing
|
#
|
# SPACE-DELIMITED
|
# SINCE 0.9.0
|
web.luceneIgnoreExtensions = 7z arc arj bin bmp dll doc docx exe gif gz jar jpg lib lzh odg odf odt pdf ppt png so swf xcf xls xlsx zip
|
|
# Registered extensions for google-code-prettify
|
#
|
# SPACE-DELIMITED
|
# SINCE 0.5.0
|
web.prettyPrintExtensions = c cpp cs css frm groovy htm html java js php pl prefs properties py rb scala sh sql xml vb
|
|
# Registered extensions for markdown transformation
|
#
|
# SPACE-DELIMITED
|
# CASE-SENSITIVE
|
# SINCE 0.5.0
|
web.markdownExtensions = md mkd markdown MD MKD
|
|
# Image extensions
|
#
|
# SPACE-DELIMITED
|
# SINCE 0.5.0
|
web.imageExtensions = bmp jpg jpeg gif png ico
|
|
# Registered extensions for binary blobs
|
#
|
# SPACE-DELIMITED
|
# SINCE 0.5.0
|
web.binaryExtensions = jar pdf tar.gz zip
|
|
# Aggressive heap management will run the garbage collector on every generated
|
# page. This slows down page generation a little but improves heap consumption.
|
#
|
# SINCE 0.5.0
|
web.aggressiveHeapManagement = false
|
|
# Run the webapp in debug mode
|
#
|
# SINCE 0.5.0
|
# RESTART REQUIRED
|
web.debugMode = false
|
|
# Enable/disable global regex substitutions (i.e. shared across repositories)
|
#
|
# SINCE 0.5.0
|
regex.global = true
|
|
# Example global regex substitutions
|
# Use !!! to separate the search pattern and the replace pattern
|
# searchpattern!!!replacepattern
|
# SINCE 0.5.0
|
regex.global.bug = \\b(Bug:)(\\s*[#]?|-){0,1}(\\d+)\\b!!!<a href="http://somehost/bug/$3">Bug-Id: $3</a>
|
# SINCE 0.5.0
|
regex.global.changeid = \\b(Change-Id:\\s*)([A-Za-z0-9]*)\\b!!!<a href="http://somehost/changeid/$2">Change-Id: $2</a>
|
|
# Example per-repository regex substitutions overrides global
|
# SINCE 0.5.0
|
regex.myrepository.bug = \\b(Bug:)(\\s*[#]?|-){0,1}(\\d+)\\b!!!<a href="http://elsewhere/bug/$3">Bug-Id: $3</a>
|
|
#
|
# Mail Settings
|
# SINCE 0.6.0
|
#
|
# Mail settings are used to notify administrators of received federation proposals
|
#
|
|
# ip or hostname of smtp server
|
#
|
# SINCE 0.6.0
|
mail.server =
|
|
# port to use for smtp requests
|
#
|
# SINCE 0.6.0
|
mail.port = 25
|
|
# debug the mail executor
|
#
|
# SINCE 0.6.0
|
mail.debug = false
|
|
# if your smtp server requires authentication, supply the credentials here
|
#
|
# SINCE 0.6.0
|
mail.username =
|
# SINCE 0.6.0
|
mail.password =
|
|
# from address for generated emails
|
#
|
# SINCE 0.6.0
|
mail.fromAddress =
|
|
# List of email addresses for the Gitblit administrators
|
#
|
# SPACE-DELIMITED
|
# SINCE 0.6.0
|
mail.adminAddresses =
|
|
# List of email addresses for sending push email notifications.
|
#
|
# This key currently requires use of the sendemail.groovy hook script.
|
# If you set sendemail.groovy in *groovy.postReceiveScripts* then email
|
# notifications for all repositories (regardless of access restrictions!)
|
# will be sent to these addresses.
|
#
|
# SPACE-DELIMITED
|
# SINCE 0.8.0
|
mail.mailingLists =
|
|
#
|
# Federation Settings
|
# SINCE 0.6.0
|
#
|
# A Gitblit federation is a way to backup one Gitblit instance to another.
|
#
|
# *git.enableGitServlet* must be true to use this feature.
|
|
# Your federation name is used for federation status acknowledgments. If it is
|
# unset, and you elect to send a status acknowledgment, your Gitblit instance
|
# will be identified by its hostname, if available, else your internal ip address.
|
# The source Gitblit instance will also append your external IP address to your
|
# identification to differentiate multiple pulling systems behind a single proxy.
|
#
|
# SINCE 0.6.0
|
federation.name =
|
|
# Specify the passphrase of this Gitblit instance.
|
#
|
# An unspecified (empty) passphrase disables processing federation requests.
|
#
|
# This value can be anything you want: an integer, a sentence, an haiku, etc.
|
# Keep the value simple, though, to avoid Java properties file encoding issues.
|
#
|
# Changing your passphrase will break any registrations you have established with other
|
# Gitblit instances.
|
#
|
# CASE-SENSITIVE
|
# SINCE 0.6.0
|
# RESTART REQUIRED *(only to enable or disable federation)*
|
federation.passphrase =
|
|
# Control whether or not this Gitblit instance can receive federation proposals
|
# from another Gitblit instance. Registering a federated Gitblit is a manual
|
# process. Proposals help to simplify that process by allowing a remote Gitblit
|
# instance to send your Gitblit instance the federation pull data.
|
#
|
# SINCE 0.6.0
|
federation.allowProposals = false
|
|
# The destination folder for cached federation proposals.
|
# Use forward slashes even on Windows!!
|
#
|
# SINCE 0.6.0
|
federation.proposalsFolder = ${baseFolder}/proposals
|
|
# The default pull frequency if frequency is unspecified on a registration
|
#
|
# SINCE 0.6.0
|
federation.defaultFrequency = 60 mins
|
|
# Federation Sets are named groups of repositories. The Federation Sets are
|
# available for selection in the repository settings page. You can assign a
|
# repository to one or more sets and then distribute the token for the set.
|
# This allows you to grant federation pull access to a subset of your available
|
# repositories. Tokens for federation sets only grant repository pull access.
|
#
|
# SPACE-DELIMITED
|
# CASE-SENSITIVE
|
# SINCE 0.6.0
|
federation.sets =
|
|
# Federation pull registrations
|
# Registrations are read once, at startup.
|
#
|
# RESTART REQUIRED
|
#
|
# frequency:
|
# The shortest frequency allowed is every 5 minutes
|
# Decimal frequency values are cast to integers
|
# Frequency values may be specified in mins, hours, or days
|
# Values that can not be parsed or are unspecified default to *federation.defaultFrequency*
|
#
|
# folder:
|
# if unspecified, the folder is *git.repositoriesFolder*
|
# if specified, the folder is relative to *git.repositoriesFolder*
|
#
|
# bare:
|
# if true, each repository will be created as a *bare* repository and will not
|
# have a working directory.
|
#
|
# if false, each repository will be created as a normal repository suitable
|
# for local work.
|
#
|
# mirror:
|
# if true, each repository HEAD is reset to *origin/master* after each pull.
|
# The repository will be flagged *isFrozen* after the initial clone.
|
#
|
# if false, each repository HEAD will point to the FETCH_HEAD of the initial
|
# clone from the origin until pushed to or otherwise manipulated.
|
#
|
# mergeAccounts:
|
# if true, remote accounts and their permissions are merged into your
|
# users.properties file
|
#
|
# notifyOnError:
|
# if true and the mail configuration is properly set, administrators will be
|
# notified by email of pull failures
|
#
|
# include and exclude:
|
# Space-delimited list of repositories to include or exclude from pull
|
# may be * wildcard to include or exclude all
|
# may use fuzzy match (e.g. org.eclipse.*)
|
|
#
|
# (Nearly) Perfect Mirror example
|
#
|
|
#federation.example1.url = https://go.gitblit.com
|
#federation.example1.token = 6f3b8a24bf970f17289b234284c94f43eb42f0e4
|
#federation.example1.frequency = 120 mins
|
#federation.example1.folder =
|
#federation.example1.bare = true
|
#federation.example1.mirror = true
|
#federation.example1.mergeAccounts = true
|
|
#
|
# Advanced Realm Settings
|
#
|
|
# URL of the LDAP server.
|
# To use encrypted transport, use either ldaps:// URL for SSL or ldap+tls:// to
|
# send StartTLS command.
|
#
|
# SINCE 1.0.0
|
realm.ldap.server = ldap://localhost
|
|
# Login username for LDAP searches.
|
# If this value is unspecified, anonymous LDAP login will be used.
|
#
|
# e.g. mydomain\\username
|
#
|
# SINCE 1.0.0
|
realm.ldap.username = cn=Directory Manager
|
|
# Login password for LDAP searches.
|
#
|
# SINCE 1.0.0
|
realm.ldap.password = password
|
|
# The LdapUserService must be backed by another user service for standard user
|
# and team management.
|
# default: users.conf
|
#
|
# SINCE 1.0.0
|
# RESTART REQUIRED
|
realm.ldap.backingUserService = test-ui-users.conf
|
|
# Delegate team membership control to LDAP.
|
#
|
# If true, team user memberships will be specified by LDAP groups. This will
|
# disable team selection in Edit User and user selection in Edit Team.
|
#
|
# If false, LDAP will only be used for authentication and Gitblit will maintain
|
# team memberships with the *realm.ldap.backingUserService*.
|
#
|
# SINCE 1.0.0
|
realm.ldap.maintainTeams = false
|
|
# Root node for all LDAP users
|
#
|
# This is the root node from which subtree user searches will begin.
|
# If blank, Gitblit will search ALL nodes.
|
#
|
# SINCE 1.0.0
|
realm.ldap.accountBase = OU=Users,OU=UserControl,OU=MyOrganization,DC=MyDomain
|
|
# Filter criteria for LDAP users
|
#
|
# Query pattern to use when searching for a user account. This may be any valid
|
# LDAP query expression, including the standard (&) and (|) operators.
|
#
|
# Variables may be injected via the ${variableName} syntax.
|
# Recognized variables are:
|
# ${username} - The text entered as the user name
|
#
|
# SINCE 1.0.0
|
realm.ldap.accountPattern = (&(objectClass=person)(sAMAccountName=${username}))
|
|
# Root node for all LDAP groups to be used as Gitblit Teams
|
#
|
# This is the root node from which subtree team searches will begin.
|
# If blank, Gitblit will search ALL nodes.
|
#
|
# SINCE 1.0.0
|
realm.ldap.groupBase = OU=Groups,OU=UserControl,OU=MyOrganization,DC=MyDomain
|
|
# Filter criteria for LDAP groups
|
#
|
# Query pattern to use when searching for a team. This may be any valid
|
# LDAP query expression, including the standard (&) and (|) operators.
|
#
|
# Variables may be injected via the ${variableName} syntax.
|
# Recognized variables are:
|
# ${username} - The text entered as the user name
|
# ${dn} - The Distinguished Name of the user logged in
|
#
|
# All attributes from the LDAP User record are available. For example, if a user
|
# has an attribute "fullName" set to "John", "(fn=${fullName})" will be
|
# translated to "(fn=John)".
|
#
|
# SINCE 1.0.0
|
realm.ldap.groupMemberPattern = (&(objectClass=group)(member=${dn}))
|
|
# LDAP users or groups that should be given administrator privileges.
|
#
|
# Teams are specified with a leading '@' character. Groups with spaces in the
|
# name can be entered as "@team name".
|
#
|
# e.g. realm.ldap.admins = john @git_admins "@git admins"
|
#
|
# SPACE-DELIMITED
|
# SINCE 1.0.0
|
realm.ldap.admins = @Git_Admins
|
|
# Attribute(s) on the USER record that indicate their display (or full) name.
|
# Leave blank for no mapping available in LDAP.
|
#
|
# This may be a single attribute, or a string of multiple attributes. Examples:
|
# displayName - Uses the attribute 'displayName' on the user record
|
# ${personalTitle}. ${givenName} ${surname} - Will concatenate the 3
|
# attributes together, with a '.' after personalTitle
|
#
|
# SINCE 1.0.0
|
realm.ldap.displayName = displayName
|
|
# Attribute(s) on the USER record that indicate their email address.
|
# Leave blank for no mapping available in LDAP.
|
#
|
# This may be a single attribute, or a string of multiple attributes. Examples:
|
# email - Uses the attribute 'email' on the user record
|
# ${givenName}.${surname}@gitblit.com -Will concatenate the 2 attributes
|
# together with a '.' and '@' creating something like first.last@gitblit.com
|
#
|
# SINCE 1.0.0
|
realm.ldap.email = email
|
|
# The RedmineUserService must be backed by another user service for standard user
|
# and team management.
|
# default: users.conf
|
#
|
# RESTART REQUIRED
|
realm.redmine.backingUserService = test-ui-users.conf
|
|
# URL of the Redmine.
|
realm.redmine.url = http://example.com/redmine
|
|
#
|
# Server Settings
|
#
|
|
# The temporary folder to decompress the embedded gitblit webapp.
|
#
|
# SINCE 0.5.0
|
# RESTART REQUIRED
|
server.tempFolder = ${baseFolder}/temp
|
|
# Use Jetty NIO connectors. If false, Jetty Socket connectors will be used.
|
#
|
# SINCE 0.5.0
|
# RESTART REQUIRED
|
server.useNio = true
|
|
# Context path for the GO application. You might want to change the context
|
# path if running Gitblit behind a proxy layer such as mod_proxy.
|
#
|
# SINCE 0.7.0
|
# RESTART REQUIRED
|
server.contextPath = /
|
|
# Standard http port to serve. <= 0 disables this connector.
|
# On Unix/Linux systems, ports < 1024 require root permissions.
|
# Recommended value: 80 or 8080
|
#
|
# SINCE 0.5.0
|
# RESTART REQUIRED
|
server.httpPort = 0
|
|
# Secure/SSL https port to serve. <= 0 disables this connector.
|
# On Unix/Linux systems, ports < 1024 require root permissions.
|
# Recommended value: 443 or 8443
|
#
|
# SINCE 0.5.0
|
# RESTART REQUIRED
|
server.httpsPort = 8443
|
|
# Port for serving an Apache JServ Protocol (AJP) 1.3 connector for integrating
|
# Gitblit GO into an Apache HTTP server setup. <= 0 disables this connector.
|
# Recommended value: 8009
|
#
|
# SINCE 0.9.0
|
# RESTART REQUIRED
|
server.ajpPort = 0
|
|
# Specify the interface for Jetty to bind the standard connector.
|
# You may specify an ip or an empty value to bind to all interfaces.
|
# Specifying localhost will result in Gitblit ONLY listening to requests to
|
# localhost.
|
#
|
# SINCE 0.5.0
|
# RESTART REQUIRED
|
server.httpBindInterface = localhost
|
|
# Specify the interface for Jetty to bind the secure connector.
|
# You may specify an ip or an empty value to bind to all interfaces.
|
# Specifying localhost will result in Gitblit ONLY listening to requests to
|
# localhost.
|
#
|
# SINCE 0.5.0
|
# RESTART REQUIRED
|
server.httpsBindInterface = localhost
|
|
# Specify the interface for Jetty to bind the AJP connector.
|
# You may specify an ip or an empty value to bind to all interfaces.
|
# Specifying localhost will result in Gitblit ONLY listening to requests to
|
# localhost.
|
#
|
# SINCE 0.9.0
|
# RESTART REQUIRED
|
server.ajpBindInterface = localhost
|
|
# Alias of certificate to use for https/SSL serving. If blank the first
|
# certificate found in the keystore will be used.
|
#
|
# SINCE 1.2.0
|
# RESTART REQUIRED
|
server.certificateAlias = localhost
|
|
# Password for SSL keystore.
|
# Keystore password and certificate password must match.
|
# This is provided for convenience, its probably more secure to set this value
|
# using the --storePassword command line parameter.
|
#
|
# If you are using the official JRE or JDK from Oracle you may not have the
|
# JCE Unlimited Strength Jurisdiction Policy files bundled with your JVM. Because
|
# of this, your store/key password can not exceed 7 characters. If you require
|
# longer passwords you may need to install the JCE Unlimited Strength Jurisdiction
|
# Policy files from Oracle.
|
#
|
# http://www.oracle.com/technetwork/java/javase/downloads/index.html
|
#
|
# Gitblit and the Gitblit Certificate Authority will both indicate if Unlimited
|
# Strength encryption is available.
|
#
|
# SINCE 0.5.0
|
# RESTART REQUIRED
|
server.storePassword = gitblit
|
|
# If serving over https (recommended) you might consider requiring clients to
|
# authenticate with ssl certificates. If enabled, only https clients with the
|
# a valid client certificate will be able to access Gitblit.
|
#
|
# If disabled, client certificate authentication is optional and will be tried
|
# first before falling-back to form authentication or basic authentication.
|
#
|
# Requiring client certificates to access any of Gitblit may be too extreme,
|
# consider this carefully.
|
#
|
# SINCE 1.2.0
|
# RESTART REQUIRED
|
server.requireClientCertificates = false
|
|
# Port for shutdown monitor to listen on.
|
#
|
# SINCE 0.5.0
|
# RESTART REQUIRED
|
server.shutdownPort = 8081
|
