Sinopsis

git instaweb [--httpd=<daemon>] [--port=<n>] [--start | --stop | --restart]

Descripción

El comando git instaweb arranca un servidor HTTP local con una instancia de gitweb apuntando a tu repo, dándote una interfaz web inmediata para navegar el historial. Útil para inspección visual sin configurar un servidor permanente.

Requiere un servidor HTTP soportado (lighttpd, apache2, nginx, webrick, plackup) instalado. git instaweb --httpd=lighttpd es la invocación típica.

En el uso diario, este comando se integra estrechamente con alias de shell, plugins de editor e integración continua. Los usuarios avanzados a menudo añaden alias que combinan los flags que siempre pasan. El formato de salida puede personalizarse vía configuración de Git. Cuando algo sale mal, ejecuta el comando con GIT_TRACE=1 para revelar las llamadas plumbing subyacentes.

Entender cómo este comando interactúa con el resto del modelo de datos de Git rinde dividendos. Cada comando opera sobre algún subconjunto de las piezas (objetos, index, refs, árbol de trabajo), y saber cuáles toca ayuda a predecir resultados y a recuperarse de errores.

Opciones comunes

Ejemplos

git instaweb --httpd=webrick
# Start gitweb backed by Ruby's WEBrick

git instaweb --port=8080 --start
# On a custom port

git instaweb --stop
# Tear down

git config --global instaweb.httpd webrick
# Save default for future invocations

Errores comunes

Missing dependencies (Perl modules for gitweb, the chosen httpd) cause cryptic errors. Some distros ship gitweb in a separate package. For modern needs, consider cgit or hosted services.

Comandos relacionados

gitweb, git daemon, git http-backend, git config