Blame files/gitolite3.rc

Pierre-Yves Chibon 5feded
# configuration variables for gitolite
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
# This file is in perl syntax.  But you do NOT need to know perl to edit it --
Pierre-Yves Chibon 5feded
# just mind the commas, use single quotes unless you know what you're doing,
Pierre-Yves Chibon 5feded
# and make sure the brackets and braces stay matched up!
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
# (Tip: perl allows a comma after the last item in a list also!)
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
# HELP for commands can be had by running the command with "-h".
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
# HELP for all the other FEATURES can be found in the documentation (look for
Pierre-Yves Chibon 5feded
# "list of non-core programs shipped with gitolite" in the master index) or
Pierre-Yves Chibon 5feded
# directly in the corresponding source file.
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
%RC = (
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    # ------------------------------------------------------------------
Pierre-Yves Chibon 5feded
Slavek Kabrda adea20
    GL_REPO_BASE                    => '/srv/git/repositories'
Slavek Kabrda adea20
Pierre-Yves Chibon 5feded
    # default umask gives you perms of '0700'; see the rc file docs for
Pierre-Yves Chibon 5feded
    # how/why you might change this
Pierre-Yves Chibon 5feded
    UMASK                           =>  0077,
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    # look for "git-config" in the documentation
Pierre-Yves Chibon 5feded
    GIT_CONFIG_KEYS                 =>  '',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    # comment out if you don't need all the extra detail in the logfile
Pierre-Yves Chibon 5feded
    LOG_EXTRA                       =>  1,
Pierre-Yves Chibon 5feded
    # syslog options
Pierre-Yves Chibon 5feded
    # 1. leave this section as is for normal gitolite logging
Pierre-Yves Chibon 5feded
    # 2. uncomment this line to log only to syslog:
Pierre-Yves Chibon 5feded
    # LOG_DEST                      => 'syslog',
Pierre-Yves Chibon 5feded
    # 3. uncomment this line to log to syslog and the normal gitolite log:
Pierre-Yves Chibon 5feded
    # LOG_DEST                      => 'syslog,normal',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    # roles.  add more roles (like MANAGER, TESTER, ...) here.
Pierre-Yves Chibon 5feded
    #   WARNING: if you make changes to this hash, you MUST run 'gitolite
Pierre-Yves Chibon 5feded
    #   compile' afterward, and possibly also 'gitolite trigger POST_COMPILE'
Pierre-Yves Chibon 5feded
    ROLES => {
Pierre-Yves Chibon 5feded
        READERS                     =>  1,
Pierre-Yves Chibon 5feded
        WRITERS                     =>  1,
Pierre-Yves Chibon 5feded
    },
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    # enable caching (currently only Redis).  PLEASE RTFM BEFORE USING!!!
Pierre-Yves Chibon 5feded
    # CACHE                         =>  'Redis',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    # ------------------------------------------------------------------
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    # rc variables used by various features
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    # the 'info' command prints this as additional info, if it is set
Pierre-Yves Chibon 5feded
        # SITE_INFO                 =>  'Please see http://blahblah/gitolite for more help',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    # the CpuTime feature uses these
Pierre-Yves Chibon 5feded
        # display user, system, and elapsed times to user after each git operation
Pierre-Yves Chibon 5feded
        # DISPLAY_CPU_TIME          =>  1,
Pierre-Yves Chibon 5feded
        # display a warning if total CPU times (u, s, cu, cs) crosses this limit
Pierre-Yves Chibon 5feded
        # CPU_TIME_WARN_LIMIT       =>  0.1,
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    # the Mirroring feature needs this
Pierre-Yves Chibon 5feded
        # HOSTNAME                  =>  "foo",
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    # TTL for redis cache; PLEASE SEE DOCUMENTATION BEFORE UNCOMMENTING!
Pierre-Yves Chibon 5feded
        # CACHE_TTL                 =>  600,
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    # ------------------------------------------------------------------
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    # suggested locations for site-local gitolite code (see cust.html)
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
        # this one is managed directly on the server
Pierre-Yves Chibon 5feded
        # LOCAL_CODE                =>  "$ENV{HOME}/local",
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
        # or you can use this, which lets you put everything in a subdirectory
Pierre-Yves Chibon 5feded
        # called "local" in your gitolite-admin repo.  For a SECURITY WARNING
Pierre-Yves Chibon 5feded
        # on this, see http://gitolite.com/gitolite/non-core.html#pushcode
Pierre-Yves Chibon 5feded
        # LOCAL_CODE                =>  "$rc{GL_ADMIN_BASE}/local",
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    # ------------------------------------------------------------------
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    # List of commands and features to enable
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
    ENABLE => [
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
        # COMMANDS
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # These are the commands enabled by default
Pierre-Yves Chibon 5feded
            'help',
Pierre-Yves Chibon 5feded
            'desc',
Pierre-Yves Chibon 5feded
            'info',
Pierre-Yves Chibon 5feded
            'perms',
Pierre-Yves Chibon 5feded
            'writable',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # Uncomment or add new commands here.
Pierre-Yves Chibon 5feded
            # 'create',
Pierre-Yves Chibon 5feded
            # 'fork',
Pierre-Yves Chibon 5feded
            # 'mirror',
Pierre-Yves Chibon 5feded
            # 'readme',
Pierre-Yves Chibon 5feded
            # 'sskm',
Pierre-Yves Chibon 5feded
            # 'D',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
        # These FEATURES are enabled by default.
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # essential (unless you're using smart-http mode)
Pierre-Yves Chibon 5feded
            'ssh-authkeys',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # creates git-config enties from gitolite.conf file entries like 'config foo.bar = baz'
Pierre-Yves Chibon 5feded
            'git-config',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # creates git-daemon-export-ok files; if you don't use git-daemon, comment this out
Pierre-Yves Chibon 5feded
            'daemon',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # creates projects.list file; if you don't use gitweb, comment this out
Pierre-Yves Chibon 5feded
            #'gitweb',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
        # These FEATURES are disabled by default; uncomment to enable.  If you
Pierre-Yves Chibon 5feded
        # need to add new ones, ask on the mailing list :-)
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
        # user-visible behaviour
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # prevent wild repos auto-create on fetch/clone
Pierre-Yves Chibon 5feded
            # 'no-create-on-read',
Pierre-Yves Chibon 5feded
            # no auto-create at all (don't forget to enable the 'create' command!)
Pierre-Yves Chibon 5feded
            # 'no-auto-create',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # access a repo by another (possibly legacy) name
Pierre-Yves Chibon 5feded
            # 'Alias',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # give some users direct shell access.  See documentation in
Pierre-Yves Chibon 5feded
            # sts.html for details on the following two choices.
Pierre-Yves Chibon 5feded
            # "Shell $ENV{HOME}/.gitolite.shell-users",
Pierre-Yves Chibon 5feded
            # 'Shell alice bob',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # set default roles from lines like 'option default.roles-1 = ...', etc.
Pierre-Yves Chibon 5feded
            # 'set-default-roles',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # show more detailed messages on deny
Pierre-Yves Chibon 5feded
            # 'expand-deny-messages',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # show a message of the day
Pierre-Yves Chibon 5feded
            # 'Motd',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
        # system admin stuff
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # enable mirroring (don't forget to set the HOSTNAME too!)
Pierre-Yves Chibon 5feded
            # 'Mirroring',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # allow people to submit pub files with more than one key in them
Pierre-Yves Chibon 5feded
            # 'ssh-authkeys-split',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # selective read control hack
Pierre-Yves Chibon 5feded
            # 'partial-copy',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # manage local, gitolite-controlled, copies of read-only upstream repos
Pierre-Yves Chibon 5feded
            # 'upstream',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # updates 'description' file instead of 'gitweb.description' config item
Pierre-Yves Chibon 5feded
            # 'cgit',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # allow repo-specific hooks to be added
Pierre-Yves Chibon 5feded
            # 'repo-specific-hooks',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
        # performance, logging, monitoring...
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # be nice
Pierre-Yves Chibon 5feded
            # 'renice 10',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # log CPU times (user, system, cumulative user, cumulative system)
Pierre-Yves Chibon 5feded
            # 'CpuTime',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
        # syntactic_sugar for gitolite.conf and included files
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # allow backslash-escaped continuation lines in gitolite.conf
Pierre-Yves Chibon 5feded
            # 'continuation-lines',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # create implicit user groups from directory names in keydir/
Pierre-Yves Chibon 5feded
            # 'keysubdirs-as-groups',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # allow simple line-oriented macros
Pierre-Yves Chibon 5feded
            # 'macros',
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
        # Kindergarten mode
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
            # disallow various things that sensible people shouldn't be doing anyway
Pierre-Yves Chibon 5feded
            # 'Kindergarten',
Pierre-Yves Chibon 5feded
    ],
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
);
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
# ------------------------------------------------------------------------------
Pierre-Yves Chibon 5feded
# per perl rules, this should be the last line in such a file:
Pierre-Yves Chibon 5feded
1;
Pierre-Yves Chibon 5feded
Pierre-Yves Chibon 5feded
# Local variables:
Pierre-Yves Chibon 5feded
# mode: perl
Pierre-Yves Chibon 5feded
# End:
Pierre-Yves Chibon 5feded
# vim: set syn=perl: