NAME | SYNOPSIS | DESCRIPTION | OPTIONS | CONFIGURATION | SEE ALSO | GIT | COLOPHON

GIT-INSTAWEB(1)                  Git Manual                  GIT-INSTAWEB(1)

NAME         top

       git-instaweb - Instantly browse your working repository in gitweb

SYNOPSIS         top

       git instaweb [--local] [--httpd=<httpd>] [--port=<port>]
                      [--browser=<browser>]
       git instaweb [--start] [--stop] [--restart]

DESCRIPTION         top

       A simple script to set up gitweb and a web server for browsing the
       local repository.

OPTIONS         top

       -l, --local
           Only bind the web server to the local IP (127.0.0.1).

       -d, --httpd
           The HTTP daemon command-line that will be executed. Command-line
           options may be specified here, and the configuration file will be
           added at the end of the command-line. Currently apache2,
           lighttpd, mongoose, plackup and webrick are supported. (Default:
           lighttpd)

       -m, --module-path
           The module path (only needed if httpd is Apache). (Default:
           /usr/lib/apache2/modules)

       -p, --port
           The port number to bind the httpd to. (Default: 1234)

       -b, --browser
           The web browser that should be used to view the gitweb page. This
           will be passed to the git web--browse helper script along with
           the URL of the gitweb instance. See git-web--browse(1) for more
           information about this. If the script fails, the URL will be
           printed to stdout.

       start, --start
           Start the httpd instance and exit. Regenerate configuration files
           as necessary for spawning a new instance.

       stop, --stop
           Stop the httpd instance and exit. This does not generate any of
           the configuration files for spawning a new instance, nor does it
           close the browser.

       restart, --restart
           Restart the httpd instance and exit. Regenerate configuration
           files as necessary for spawning a new instance.

CONFIGURATION         top

       You may specify configuration in your .git/config

           [instaweb]
                   local = true
                   httpd = apache2 -f
                   port = 4321
                   browser = konqueror
                   modulePath = /usr/lib/apache2/modules

       If the configuration variable instaweb.browser is not set,
       web.browser will be used instead if it is defined. See
       git-web--browse(1) for more information about this.

SEE ALSO         top

       gitweb(1)

GIT         top

       Part of the git(1) suite

COLOPHON         top

       This page is part of the git (Git distributed version control system)
       project.  Information about the project can be found at 
       ⟨http://git-scm.com/⟩.  If you have a bug report for this manual page,
       see ⟨http://git-scm.com/community⟩.  This page was obtained from the
       project's upstream Git repository ⟨https://github.com/git/git.git⟩ on
       2017-03-13.  If you discover any rendering problems in this HTML ver‐
       sion of the page, or you believe there is a better or more up-to-date
       source for the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original man‐
       ual page), send a mail to man-pages@man7.org

Git 2.9.2.277.g2949358           07/16/2016                  GIT-INSTAWEB(1)