# phpman > man > git-instaweb(1)

> **TLDR:** Helper to launch a GitWeb server.
>
- Launch a GitWeb server for the current Git repository:
  `git instaweb --start`
- Listen only on localhost:
  `git instaweb --start {{-l|--local}}`
- Listen on a specific port:
  `git instaweb --start {{-p|--port}} {{1234}}`
- Use a specified HTTP daemon:
  `git instaweb --start {{-d|--httpd}} {{lighttpd|apache2|mongoose|plackup|webrick}}`
- Also auto-launch a web browser:
  `git instaweb --start {{-b|--browser}}`
- Stop the currently running GitWeb server:
  `git instaweb --stop`
- Restart the currently running GitWeb server:
  `git instaweb --restart`

*Source: tldr-pages*

---

[GIT-INSTAWEB(1)](https://www.chedong.com/phpMan.php/man/GIT-INSTAWEB/1/markdown)                              Git Manual                              [GIT-INSTAWEB(1)](https://www.chedong.com/phpMan.php/man/GIT-INSTAWEB/1/markdown)



## NAME
       git-instaweb - Instantly browse your working repository in gitweb

## SYNOPSIS
       _git_ _instaweb_ [--local] [--httpd=<httpd>] [--port=<port>]
                      [--browser=<browser>]
       _git_ _instaweb_ [--start] [--stop] [--restart]


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

## OPTIONS
### -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, python 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)](https://www.chedong.com/phpMan.php/man/web--browse/1/markdown) 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
       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)](https://www.chedong.com/phpMan.php/man/git-web--browse/1/markdown) for more information about this.

## SEE ALSO
       [**gitweb**(1)](https://www.chedong.com/phpMan.php/man/gitweb/1/markdown)

## GIT
       Part of the [**git**(1)](https://www.chedong.com/phpMan.php/man/git/1/markdown) suite



Git 2.34.1                                   02/26/2026                              [GIT-INSTAWEB(1)](https://www.chedong.com/phpMan.php/man/GIT-INSTAWEB/1/markdown)