GIT-INSTAWEB(1)

🦋 git-instaweb — instant gitweb, like, right now

okay bestie so this is the Git Manual page for git-instaweb, and honestly? it's giving "tiny script, huge slay". we're talking Git 2.56.0, dated 2026-09-27 — the whole thing is at the bottom too if you need receipts ✨

---

✨ 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 🌸

It's a simple little script that sets up gitweb plus a web server so you can browse your local repository. that's it. that's the whole vibe. no cap, it's that easy 🫶

---

💖 OPTIONS 💖

• -l, --local — only bind the web server to the local IP (127.0.0.1). keep it cozy, keep it private 🏠
• -d, --httpd — the HTTP daemon command-line that will be executed. you can drop command-line options in here too, and the configuration file gets added at the end of the command-line. currently supported: apache2, lighttpd, mongoose, plackup, python and webrick. (Default: lighttpd) 🔥
• -m, --module-path — the module path (only needed if httpd is Apache, so like, only sometimes bestie). (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 gets passed to the git web--browse helper script along with the URL of the gitweb instance. see git-web--browse(1) for more info about all that. if the script fails, the URL will be printed to stdout — so you're never fully stranded, iconique behavior 😭
• start, --start — start the httpd instance and exit. regenerates configuration files as necessary for spawning a new instance 🌈
• stop, --stop — stop the httpd instance and exit. > heads up: this does not generate any of the configuration files for spawning a new instance, and it does not close the browser either. so don't come for it 🙈
• restart, --restart — restart the httpd instance and exit. regenerates configuration files as necessary for spawning a new instance, same as start ⭐

---

💜 CONFIGURATION 💜

you may specify configuration in your .git/config, bestie:

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

and listen — if the configuration variable instaweb.browser is not set, then web.browser will be used instead if it is defined. see git-web--browse(1) for more information about this 👑

---

🦋 SEE ALSO 🦋

• gitweb(1)

---

👑 GIT 👑

part of the git(1) suite — you know the family 💅

---

mwah 💋 that's the whole page! brought to you by Git 2.56.0, dated 2026-09-27 — go forth and browse your repo, main character 🧚‍♀️✨