Pick any line to see why it is the way it is: the commit, the pull request and issue it came from, and what the agent was thinking.
| Running g1t yourself: the design, a docker compose proof, and a guide to what works today | 1 | # Self-hosted g1t, phase 1: the core forge on your own machine. |
| 2 | # | |
| 3 | # docker compose -f deploy/self-host/docker-compose.yml up --build | |
| 4 | # | |
| 5 | # Then open http://localhost:8787. Mail (the confirmation link at sign-up) | |
| Merge branch 'worktree-agent-aaf03bdceac799c89' | 6 | # lands in Mailpit at http://localhost:8025. The API is at |
| 7 | # http://localhost:8789 and the MCP server at http://localhost:8789/mcp. | |
| Running g1t yourself: the design, a docker compose proof, and a guide to what works today | 8 | # |
| 9 | # What runs: the site and every core service in one workerd (g1t), git | |
| Merge branch 'worktree-agent-aaf03bdceac799c89' | 10 | # repositories as bare repos on a volume (gitstore), the API in a second |
| 11 | # workerd beside it, packages' files, backups and the clone pack cache in | |
| Merge branch 'worktree-agent-af58ac8933b0dd125' | 12 | # RustFS (S3-compatible storage), and Mailpit for mail. |
| Running g1t yourself: the design, a docker compose proof, and a guide to what works today | 13 | # Agents, deployments, context search and billing are off. See |
| 14 | # docs/SELF_HOSTING.md. | |
| 15 | name: g1t | |
| 16 | ||
| 17 | services: | |
| 18 | g1t: | |
| 19 | build: | |
| 20 | context: ../.. | |
| 21 | dockerfile: deploy/self-host/Dockerfile | |
| 22 | ports: | |
| 23 | - "${G1T_PORT:-8787}:8787" | |
| Merge branch 'worktree-agent-aaf03bdceac799c89' | 24 | - "${API_PORT:-8789}:8789" |
| Running g1t yourself: the design, a docker compose proof, and a guide to what works today | 25 | environment: |
| Merge branch 'worktree-agent-aaf03bdceac799c89' | 26 | # Where people reach this installation. Links in mail, clone URLs and |
| 27 | # the site's meta tags point here. | |
| Running g1t yourself: the design, a docker compose proof, and a guide to what works today | 28 | PUBLIC_URL: ${PUBLIC_URL:-http://localhost:8787} |
| Merge branch 'worktree-agent-aaf03bdceac799c89' | 29 | # Where the API (REST, OAuth) is reached, and its OAuth issuer; empty |
| 30 | # means PUBLIC_URL's host on API_PORT. MCP_URL, empty, is API_URL/mcp. | |
| 31 | API_URL: ${API_URL:-} | |
| 32 | MCP_URL: ${MCP_URL:-} | |
| 33 | API_PORT: ${API_PORT:-8789} | |
| Running g1t yourself: the design, a docker compose proof, and a guide to what works today | 34 | GITSTORE_URL: http://gitstore:8080 |
| 35 | GITSTORE_SECRET_FILE: /secrets/gitstore | |
| 36 | MAIL_URL: ${MAIL_URL:-http://mailpit:8025} | |
| 37 | MAIL_FROM: ${MAIL_FROM:-g1t <noreply@localhost>} | |
| Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look | 38 | # Your own GitHub App, for "Continue with GitHub" and importing from |
| 39 | # GitHub. Leave these unset to have neither. See the self-hosting guide. | |
| 40 | GITHUB_APP_ID: ${GITHUB_APP_ID:-} | |
| 41 | GITHUB_APP_SLUG: ${GITHUB_APP_SLUG:-} | |
| 42 | GITHUB_APP_CLIENT_ID: ${GITHUB_APP_CLIENT_ID:-} | |
| 43 | GITHUB_APP_CLIENT_SECRET: ${GITHUB_APP_CLIENT_SECRET:-} | |
| 44 | GITHUB_APP_PRIVATE_KEY: ${GITHUB_APP_PRIVATE_KEY:-} | |
| 45 | GITHUB_APP_WEBHOOK_SECRET: ${GITHUB_APP_WEBHOOK_SECRET:-} | |
| 46 | # open: anyone may register. invite: a new account needs an invite | |
| 47 | # code, as on g1t.sh; the owners of INVITE_STAFF_WORKSPACES (slugs, | |
| 48 | # comma separated) invite without limit, everyone else INVITES_PER_USER. | |
| 49 | REGISTRATION_MODE: ${REGISTRATION_MODE:-open} | |
| 50 | INVITE_STAFF_WORKSPACES: ${INVITE_STAFF_WORKSPACES:-} | |
| 51 | INVITES_PER_USER: ${INVITES_PER_USER:-} | |
| status.g1t.sh with incident management, invites that land you in the workspace, settings as pages, usage without quotas | 52 | # Where summaries of new access requests go; empty sends none. |
| 53 | WAITLIST_NOTIFY_EMAIL: ${WAITLIST_NOTIFY_EMAIL:-} | |
| Merge branch 'worktree-agent-af58ac8933b0dd125' | 54 | # Packages' files (container images and the rest), in RustFS below or |
| Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member | 55 | # any S3-compatible store. S3_PUBLIC_ENDPOINT, when clients can reach |
| 56 | # the store, sends large downloads there directly. | |
| Merge branch 'worktree-agent-af58ac8933b0dd125' | 57 | S3_ENDPOINT: ${S3_ENDPOINT:-http://rustfs:9000} |
| Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member | 58 | S3_BUCKET: ${S3_BUCKET:-g1t-packages} |
| 59 | S3_REGION: ${S3_REGION:-us-east-1} | |
| 60 | S3_ACCESS_KEY_ID: ${S3_ACCESS_KEY_ID:-g1t} | |
| 61 | S3_SECRET_ACCESS_KEY: ${S3_SECRET_ACCESS_KEY:-g1t-packages-secret} | |
| 62 | S3_PUBLIC_ENDPOINT: ${S3_PUBLIC_ENDPOINT:-} | |
| Merge branch 'worktree-agent-ac5b181a013e54348' | 63 | # Nightly backups' bundles and manifests, in a bucket of their own on |
| 64 | # the same store (docs/SELF_HOSTING.md, "Backups"). | |
| 65 | BACKUP_S3_BUCKET: ${BACKUP_S3_BUCKET:-g1t-backups} | |
| Merge branch 'worktree-agent-aaf03bdceac799c89' | 66 | # Packs kept for fresh clones, so the next clone of the same commit |
| Merge branch 'worktree-agent-af58ac8933b0dd125' | 67 | # does not rebuild one; storage-setup expires them after 7 days. |
| Merge branch 'worktree-agent-aaf03bdceac799c89' | 68 | PACK_S3_BUCKET: ${PACK_S3_BUCKET:-g1t-git-packs} |
| Running g1t yourself: the design, a docker compose proof, and a guide to what works today | 69 | volumes: |
| 70 | - g1t-data:/data | |
| 71 | - g1t-secrets:/secrets:ro | |
| 72 | depends_on: | |
| 73 | gitstore: | |
| 74 | condition: service_healthy | |
| 75 | mailpit: | |
| 76 | condition: service_started | |
| Merge branch 'worktree-agent-af58ac8933b0dd125' | 77 | storage-setup: |
| Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member | 78 | condition: service_completed_successfully |
| Running g1t yourself: the design, a docker compose proof, and a guide to what works today | 79 | restart: unless-stopped |
| 80 | ||
| status.g1t.sh with incident management, invites that land you in the workspace, settings as pages, usage without quotas | 81 | # The status page, in a process of its own so it stays up when the site |
| 82 | # does not: http://localhost:8788. It checks the site every minute. | |
| 83 | status: | |
| 84 | build: | |
| 85 | context: ../.. | |
| 86 | dockerfile: deploy/self-host/Dockerfile | |
| 87 | command: ["bash", "deploy/self-host/status.sh"] | |
| 88 | ports: | |
| 89 | - "${STATUS_PORT:-8788}:8788" | |
| 90 | environment: | |
| 91 | PUBLIC_URL: ${PUBLIC_URL:-http://localhost:8787} | |
| 92 | # How the status page reaches the site, from inside Compose. | |
| 93 | STATUS_CHECK_URL: http://g1t:8787 | |
| 94 | # A public repository, `workspace/repo`, whose branches it lists as a | |
| 95 | # clone would. Empty: git is not checked. | |
| 96 | STATUS_PROBE_REPO: ${STATUS_PROBE_REPO:-} | |
| 97 | volumes: | |
| 98 | - g1t-status:/data | |
| 99 | restart: unless-stopped | |
| 100 | ||
| Running g1t yourself: the design, a docker compose proof, and a guide to what works today | 101 | gitstore: |
| 102 | build: | |
| 103 | context: ./gitstore | |
| 104 | environment: | |
| 105 | GITSTORE_URL: http://gitstore:8080 | |
| 106 | GITSTORE_SECRET_FILE: /secrets/gitstore | |
| 107 | volumes: | |
| 108 | - g1t-git:/data/git | |
| 109 | - g1t-secrets:/secrets | |
| 110 | # Not published: only the g1t container reaches it. | |
| 111 | restart: unless-stopped | |
| 112 | ||
| Merge branch 'worktree-agent-af58ac8933b0dd125' | 113 | # Packages' files, backups and clone packs, in RustFS (S3-compatible). |
| 114 | # Not published: only the g1t container reaches it, unless you publish | |
| 115 | # 9000 and set S3_PUBLIC_ENDPOINT. Any S3-compatible store works in its | |
| 116 | # place (S3_ENDPOINT). | |
| 117 | rustfs: | |
| 118 | image: ${RUSTFS_IMAGE:-rustfs/rustfs:1.0.1} | |
| Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member | 119 | environment: |
| Merge branch 'worktree-agent-af58ac8933b0dd125' | 120 | RUSTFS_ACCESS_KEY: ${S3_ACCESS_KEY_ID:-g1t} |
| 121 | RUSTFS_SECRET_KEY: ${S3_SECRET_ACCESS_KEY:-g1t-packages-secret} | |
| 122 | RUSTFS_CONSOLE_ENABLE: "false" | |
| Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member | 123 | volumes: |
| Merge branch 'worktree-agent-af58ac8933b0dd125' | 124 | - g1t-objects:/data |
| Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member | 125 | healthcheck: |
| Merge branch 'worktree-agent-af58ac8933b0dd125' | 126 | test: ["CMD", "curl", "-fsS", "-o", "/dev/null", "http://localhost:9000/health/ready"] |
| Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member | 127 | interval: 5s |
| 128 | retries: 20 | |
| 129 | restart: unless-stopped | |
| 130 | ||
| Merge branch 'worktree-agent-aaf03bdceac799c89' | 131 | # Makes the buckets once, then exits: packages' files, backups, and |
| Merge branch 'worktree-agent-af58ac8933b0dd125' | 132 | # clone packs, with a lifecycle rule on the packs' bucket that deletes |
| 133 | # packs 7 days old and uploads left unfinished after a day. | |
| 134 | storage-setup: | |
| 135 | image: ${AWS_CLI_IMAGE:-amazon/aws-cli:2.37.10} | |
| Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member | 136 | depends_on: |
| Merge branch 'worktree-agent-af58ac8933b0dd125' | 137 | rustfs: |
| Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member | 138 | condition: service_healthy |
| 139 | entrypoint: | |
| 140 | - sh | |
| 141 | - -c | |
| Merge branch 'worktree-agent-aaf03bdceac799c89' | 142 | - >- |
| 143 | set -e; | |
| Merge branch 'worktree-agent-af58ac8933b0dd125' | 144 | for bucket in "$$S3_BUCKET" "$$BACKUP_S3_BUCKET" "$$PACK_S3_BUCKET"; do |
| 145 | aws s3api head-bucket --bucket "$$bucket" >/dev/null 2>&1 || aws s3api create-bucket --bucket "$$bucket" >/dev/null; | |
| 146 | done; | |
| 147 | aws s3api put-bucket-lifecycle-configuration --bucket "$$PACK_S3_BUCKET" --lifecycle-configuration | |
| 148 | '{"Rules":[{"ID":"expire-packs","Status":"Enabled","Filter":{"Prefix":"packs/"},"Expiration":{"Days":7}},{"ID":"abort-unfinished-uploads","Status":"Enabled","Filter":{"Prefix":""},"AbortIncompleteMultipartUpload":{"DaysAfterInitiation":1}}]}'; | |
| 149 | echo "buckets ready" | |
| Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member | 150 | environment: |
| Merge branch 'worktree-agent-af58ac8933b0dd125' | 151 | AWS_ENDPOINT_URL: http://rustfs:9000 |
| 152 | AWS_ACCESS_KEY_ID: ${S3_ACCESS_KEY_ID:-g1t} | |
| 153 | AWS_SECRET_ACCESS_KEY: ${S3_SECRET_ACCESS_KEY:-g1t-packages-secret} | |
| 154 | AWS_DEFAULT_REGION: ${S3_REGION:-us-east-1} | |
| Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member | 155 | S3_BUCKET: ${S3_BUCKET:-g1t-packages} |
| Merge branch 'worktree-agent-ac5b181a013e54348' | 156 | BACKUP_S3_BUCKET: ${BACKUP_S3_BUCKET:-g1t-backups} |
| Merge branch 'worktree-agent-aaf03bdceac799c89' | 157 | PACK_S3_BUCKET: ${PACK_S3_BUCKET:-g1t-git-packs} |
| Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member | 158 | |
| Running g1t yourself: the design, a docker compose proof, and a guide to what works today | 159 | mailpit: |
| 160 | image: axllent/mailpit:latest | |
| 161 | ports: | |
| 162 | - "${MAILPIT_PORT:-8025}:8025" | |
| 163 | # To deliver for real, relay through your SMTP server: | |
| 164 | # environment: | |
| 165 | # MP_SMTP_RELAY_HOST: smtp.example.com | |
| 166 | # MP_SMTP_RELAY_PORT: "587" | |
| 167 | # MP_SMTP_RELAY_USERNAME: ... | |
| 168 | # MP_SMTP_RELAY_PASSWORD: ... | |
| 169 | # MP_SMTP_RELAY_ALL: "true" | |
| 170 | restart: unless-stopped | |
| 171 | ||
| 172 | volumes: | |
| 173 | g1t-data: | |
| Merge branch 'worktree-agent-af58ac8933b0dd125' | 174 | g1t-objects: |
| status.g1t.sh with incident management, invites that land you in the workspace, settings as pages, usage without quotas | 175 | g1t-status: |
| Running g1t yourself: the design, a docker compose proof, and a guide to what works today | 176 | g1t-git: |
| 177 | g1t-secrets: |
This file's history is long; its oldest lines are credited to the oldest commit read.