---
owner: gmikcon
status: active
last_reviewed: 2026-10-26
review_interval: 30d
confidence: high
source_of_truth: gitbucket-api-and-nginx-proxy
---

# GitBucket

GitBucket is the central Git hosting service for the owner's projects.

## Access

- Public URL: `https://git.gnexus.space/`
- API base URL: `https://git.gnexus.space/api/v3`
- Repository owner observed: `root`
- Authentication: personal access token, owner-managed.
- Secret values are not stored in this repository.

## Infrastructure Path

Public access follows the standard `gnexus.space` route:

`Internet -> external-vps -> OpenVPN tunnel -> internal-proxy-vps -> internal-nginx-proxy -> gitbucket VM`

Known routing:

- Domain: `git.gnexus.space`
- Internal nginx upstream: `http://192.168.1.156`
- VM inventory id: `gitbucket`
- Hypervisor: `hp-proliant-dl380-g6`
- VM resources: 4 vCPU, 8192 MiB RAM.

## SSH Access (verified 2026-10-13, navi rei)

- From the navi host, password SSH to the VM works: `ubuntu@192.168.1.156` or `navi@192.168.1.156`. The password is in gnexus-creds secret `bserv@192.168.1.130` (same password as hypervisor user `bserv`).
- Key auth is denied (publickey,password only, no authorized keys) — use password auth.
- On the VM, user `navi` has passwordless sudo (`sudo -n` works); user `ubuntu` requires a password for sudo.
- Service: systemd unit `gitbucket`, `User=gitbucket`, `ExecStart=/usr/bin/authbind --deep /usr/bin/java -Xms1g -Xmx4g -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -jar /home/ubuntu/gitbucket.war --port=80`.
- Logs: `journalctl -u gitbucket` (Jetty errors incl. `EofException` from aborted archive downloads); activity log `/home/ubuntu/.gitbucket/activity.log`; data dir `/home/ubuntu/.gitbucket/`.
- The internal-proxy VM nginx access log distinguishes external clients (they arrive as `192.168.1.150`, the ovpn VM); sudo there requires a password (`sudo -S`). Proxy LAN address is `192.168.1.183` since 2026-10-17 (was `192.168.1.226` before the 2026-10-16/17 blackout).

## VM Disk

Observed 2026-09-19 on hypervisor `hp-proliant-dl380-g6` (SSH user `bserv`, credentials in gnexus-creds secret `bserv@192.168.1.130`):

- Disk image: `/mnt/main/vm_main/gitbucket` (raw, 100 GiB, fully allocated).
- Partition layout (dos label):
  - `p1`: ext4, ~28 GiB — root filesystem. Used 5.4G, free 21G (21%).
  - `p5` (extended): ext4, ~71 GiB — data. Used 3.8G, free 64G (6%).
- Hypervisor storage `/mnt/main` (`/dev/sdb`): 2.5T total, 1.6T used, 730G free (69%).
- No QEMU guest agent connected to this VM; direct SSH from hypervisor to VM is not configured (key auth denied for root/ubuntu/bserv; password auth from the navi host works — see SSH Access). Disk-level inspection works via read-only loop mount on the hypervisor: `losetup -f --show -r -P /mnt/main/vm_main/gitbucket`, then `mount -o ro,noload`.

## Role

This service is the source of truth for software projects. Agents should use it to:

- discover repositories;
- connect deployed services to their source repositories;
- find upstream README/docs/runbooks;
- identify project ownership, public/private status, and default branches.

Agents should not:

- store access tokens in docs;
- clone or read secret-bearing files unless explicitly instructed;
- treat every repository as a deployed service;
- infer production ownership without deployment evidence.

## Known issues

- **`/archive/<sha>.zip` endpoint is CPU-bound** (root cause established 2026-10-13, navi rei, SSH into the VM): GitBucket deflates the requested repository/subdirectory on the fly (commons-compress `ZipArchiveOutputStream`). When the client disconnects mid-download, Jetty logs `EofException` in `RepositoryViewerController` (`journalctl -u gitbucket`), but the deflate work already burned CPU. External crawler traffic (browser-like UAs, arriving through ovpn VM 192.168.1.150, referers = tree pages) downloading `/archive/*.zip` caused the 2026-10-12 cpu_high storm on server 44 (~9h40m, 16+ recoveries, self-extinguished ~14:35 UTC) and single spikes (e.g. 2026-10-13 10:32 UTC, 99.6%, self-recovered <1 min). Candidate fixes, owner decision pending: nginx rate-limit or block of `/archive/` and crawler UAs on internal-proxy (`.183` since 2026-10-17, formerly `.226`), `robots.txt`. Incident journal: `workspace/incident_gitbucket_cpu_2026-10-12.md` (navi rei workspace).
- **Recurrence 2026-10-26 17:44 UTC** (panel #1081, cpu_high 99.2%, self-recovered ~2 min, SSH triage by navi rei): 4th episode of the same class. 2705 `/archive/*.zip` requests that day via internal-proxy `.183` (all arriving as ovpn VM 192.168.1.150); UAs now include named bots — Reflectionbot/1.0 (607), ClaudeBot/1.0 (290), SemrushBot/7 — plus fake browser UAs (Chrome 142–154, Firefox 156); 53 client aborts (499), 11 upstream 500s. Storm came in short waves (15:40/16:43/17:19/17:37 UTC) with the main peak at 17:44 and self-extinguished; no restart applied. Strengthens the case for the pending nginx rate-limit/block fix.
- **java (GitBucket) holds ~63% MEM (5.3 GiB of 8 GiB) permanently**, also in quiet periods — heap pressure is a standing risk factor during any future CPU storm.

## Repository Snapshot

Observed through GitBucket API on 2026-05-10.

Total repositories visible to `root`: 65.

Activity labels are based only on last commit date:

- `active-2026`: touched in 2026.
- `dormant-2025`: last touched in 2025; likely inactive unless deployment evidence says otherwise.
- `old-2024`: last touched in 2024; treat as abandoned/archive candidate until confirmed.

| Repository | Visibility | Branch | Last commit | SHA | Activity | Description |
| --- | --- | --- | --- | --- | --- | --- |
| `navi-1` | private | `master` | 2026-05-09 | `6d21570` | active-2026 |  |
| `gnexus-book` | public | `master` | 2026-05-08 | `b70ad67` | active-2026 |  |
| `gnexus-ui-kit` | public | `master` | 2026-05-08 | `f7fb261` | active-2026 |  |
| `mardis_calc` | public | `master` | 2026-05-06 | `25a01e5` | active-2026 |  |
| `gnexus-auth` | private | `master` | 2026-05-05 | `4ce05a5` | active-2026 |  |
| `gnexus-auth-client-py` | public | `master` | 2026-05-04 | `9a087f1` | active-2026 |  |
| `smart-home-server` | public | `master` | 2026-04-25 | `d81f6d6` | active-2026 |  |
| `gnexus-auth-client-php` | public | `main` | 2026-04-24 | `c95c99f` | active-2026 |  |
| `lytvak` | private | `master` | 2026-04-18 | `6dea7fc` | active-2026 |  |
| `navi-webclient` | private | `master` | 2026-04-15 | `8d0c3e9` | active-2026 |  |
| `ubuntu_server_scripts` | public | `master` | 2026-04-01 | `4070c62` | active-2026 |  |
| `medialib-manager` | public | `master` | 2026-04-01 | `a5c8f1e` | active-2026 |  |
| `exp-cats-new` | public | `master` | 2026-03-31 | `2f1ef31` | active-2026 |  |
| `DOCS` | private | `master` | 2026-03-29 | `1b37dbb` | active-2026 | Документация которую можно использовать для применения с помощью ИИ к проекту. |
| `gnexus-welcome-page` | public | `main` | 2026-03-29 | `c7d6ed2` | active-2026 |  |
| `todo-ai` | private | `master` | 2025-10-28 | `f102d88` | dormant-2025 |  |
| `con2` | private | `master` | 2025-10-10 | `ecb9d38` | dormant-2025 |  |
| `fast-kognitest` | public | `master` | 2025-08-04 | `adfd80c` | dormant-2025 |  |
| `gate_interface` | private | `master` | 2025-07-18 | `85a2c94` | dormant-2025 |  |
| `vmk-demo-bot` | public | `master` | 2025-07-15 | `5dcc60a` | dormant-2025 |  |
| `mia_bot` | private | `master` | 2025-06-06 | `17060f8` | dormant-2025 |  |
| `fix-cyrillic` | public | `master` | 2025-05-26 | `1b37dbb` | dormant-2025 |  |
| `duck-search-for-ai` | private | `master` | 2025-04-25 | `27b45d5` | dormant-2025 |  |
| `voice-gen` | private | `master` | 2025-04-24 | `2736181` | dormant-2025 |  |
| `web-page-scrubber` | private | `master` | 2025-04-22 | `2746c22` | dormant-2025 |  |
| `whisper` | private | `master` | 2025-04-22 | `2746c22` | dormant-2025 |  |
| `simple_task_manager` | public | `master` | 2025-04-20 | `ef26765` | dormant-2025 |  |
| `projectX` | private | `master` | 2025-03-14 | `b97de18` | dormant-2025 |  |
| `say_themes` | private | `master` | 2025-03-12 | `1b37dbb` | dormant-2025 |  |
| `translater` | private | `master` | 2025-03-03 | `1b37dbb` | dormant-2025 |  |
| `gen-img-from-track` | private | `master` | 2025-02-25 | `ac30972` | dormant-2025 |  |
| `radio` | private | `master` | 2025-02-23 | `a5c8f1e` | dormant-2025 |  |
| `radio-streamer` | private | `master` | 2025-02-23 | `a5c8f1e` | dormant-2025 |  |
| `playlist-maker` | private | `master` | 2025-02-22 | `4cac173` | dormant-2025 |  |
| `scover` | public | `master` | 2025-02-22 | `c95c99f` | dormant-2025 |  |
| `vec_search` | private | `master` | 2025-02-20 | `a5c8f1e` | dormant-2025 |  |
| `yummspace` | public | `master` | 2025-02-17 | `a5c8f1e` | dormant-2025 |  |
| `nexp1` | private | `master` | 2025-02-13 | `7b04d51` | dormant-2025 |  |
| `tf-idf` | public | `master` | 2025-02-08 | `b040e30` | dormant-2025 |  |
| `con` | private | `master` | 2025-02-08 | `b040e30` | dormant-2025 |  |
| `vmk-olainfarm-db-backup` | private | `master` | 2025-01-28 | `431dcf5` | dormant-2025 |  |
| `clear-wplms-students` | public | `master` | 2025-01-28 | `92a7c96` | dormant-2025 |  |
| `wwwcats` | public | `master` | 2025-01-22 | `4b45804` | dormant-2025 |  |
| `ferumina-xml-products` | private | `master` | 2025-01-06 | `1b37dbb` | dormant-2025 |  |
| `flow-task` | public | `master` | 2024-12-29 | `b97de18` | old-2024 |  |
| `disk-space-api` | private | `master` | 2024-12-13 | `ef26e5f` | old-2024 |  |
| `taskmanager` | public | `master` | 2024-12-07 | `2f8598d` | old-2024 |  |
| `vue-indexer` | public | `master` | 2024-09-24 | `3e69344` | old-2024 |  |
| `open-logistic-tycoon` | public | `master` | 2024-07-10 | `bd50659` | old-2024 |  |
| `olainfarm` | private | `master` | 2024-07-09 | `1b37dbb` | old-2024 |  |
| `wppverif` | private | `master` | 2024-06-20 | `c95c99f` | old-2024 |  |
| `wpp-verif` | private | `master` | 2024-06-19 | `30becd1` | old-2024 |  |
| `wplms_user_transport` | private | `master` | 2024-06-18 | `37a2c96` | old-2024 |  |
| `home-web-panel` | private | `master` | 2024-06-06 | `1e68e09` | old-2024 |  |
| `music-loader` | public | `master` | 2024-05-23 | `fbbef1a` | old-2024 |  |
| `gnexus-blog` | private | `master` | 2024-05-21 | `74f9da5` | old-2024 |  |
| `gnexus-scope` | private | `master` | 2024-05-14 | `99b4f07` | old-2024 |  |
| `sshffmpeg` | private | `master` | 2024-05-14 | `0aaa35c` | old-2024 |  |
| `music-parser` | private | `master` | 2024-04-25 | `f52a9dd` | old-2024 | For parsing music tracks from chosic.com |
| `anicusi` | public | `master` | 2024-04-11 | `5b04d51` | old-2024 |  |
| `upsmon` | private | `master` | 2024-03-23 | `43fed98` | old-2024 |  |
| `subnet_status` | private | `main` | 2024-03-17 | `5467f6d` | old-2024 |  |
| `vmk_servier` | private | `main` | 2024-02-27 | `342fb05` | old-2024 |  |
| `kimai` | private | `main` | 2024-02-13 | `1b37dbb` | old-2024 |  |
| `store` | private | `master` | 2024-01-30 | `1b37dbb` | old-2024 |  |

## Follow-Up Classification

Repositories should be promoted from this catalog into detailed project records when one of these is true:

- the project is deployed on a host or VM;
- the project owns a public domain or internal endpoint;
- the project is an infrastructure tool;
- the project is actively maintained;
- the project has reusable documentation for other agents.

Useful next groups:

- Gnexus core: `gnexus-auth`, `gnexus-auth-client-py`, `gnexus-auth-client-php`, `gnexus-ui-kit`, `gnexus-book`, `gnexus-handbook`.
- Public services: `gnexus-welcome-page`, `lytvak`, `navi-1`, `navi-webclient`, `smart-home-server`.
- AI/search/media tools: `vec_search`, `duck-search-for-ai`, `web-page-scrubber`, `voice-gen`, `whisper`, `music-parser`.
- Home/infrastructure tools: `smart-home-server`, `home-web-panel`, `subnet_status`, `upsmon`, `disk-space-api`, `ubuntu_server_scripts`.

## Credential Policy

GitBucket credentials are owner-managed and must not be stored in this repository. If a personal access token is used for documentation work, it should be considered temporary and revoked or rotated after the documentation pass.
