Quick Start

Git Web Manager

Get Git Web Manager running and deploy your first repository.

Overview Installation

1. Install PHP Dependencies

composer install

This repository currently requires wallabydesigns/gitmanager-enterprise. Configure a valid Composer source (local path repo for development or private Composer registry for production) before running composer install.

GWM itself ships static UI assets and does not require npm install, node_modules, Vite, or Tailwind compilation for the app interface.

2. Configure Environment

Copy .env.example to .env and update the required settings:

  • APP_URL
  • DB_*
  • GITHUB_TOKEN (for private repos + Dependabot)

Docker Quick Start (Optional)

If you prefer containers, keep the same .env file and start Docker with:

docker compose --env-file .env.docker up -d --build

.env.docker is only for Docker Compose interpolation. The app still reads settings from .env.

If any value in .env contains a $, wrap it in single quotes to avoid Compose interpolation warnings.

3. Run Migrations

php artisan migrate

Git Web Manager runs on Laravel, so database migrations use artisan. If you use a custom PHP path, prefix the command.

4. Create the First User

Registration is open only when no users exist. Visit /register once to create the first admin account, then registration closes automatically.

5. Add Your First Project

  • Go to Projects → New Project.
  • Provide repo URL, local path, and branch.
  • Use the Configuration step to paste your .env and optional .htaccess before deploying (prefill from .env.example or .env.sample when available).
  • After creation, use the project Environment tab to edit or create the project .env file directly.
  • If your database already contains Laravel tables, enable the migration safety override on the Build & Deploy step to skip “table already exists” errors.
  • Press Deploy.

Community Edition allows up to 5 projects. Enterprise unlocks unlimited projects.