Newer
Older
gnexus-book / 10-systems / applications / gitbucket.md

owner: gmikcon status: active last_reviewed: 2026-10-13 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 (192.168.1.226) nginx access log distinguishes external clients (they arrive as 192.168.1.150, the ovpn VM); sudo there requires a password (sudo -S).

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 .226, robots.txt. Incident journal: workspace/incident_gitbucket_cpu_2026-10-12.md (navi rei workspace).
  • 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 a58347b 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 852a62 dormant-2025
vmk-demo-bot public master 2025-07-15 5dcc60 dormant-2025
mia_bot private master 2025-06-06 17060f8 dormant-2025
fix-cyrillic public master 2025-05-26 1bb4de2 dormant-2025
duck-search-for-ai private master 2025-04-25 27b45d5 dormant-2025
voice-gen private master 2025-04-24 4736181 dormant-2025
web-page-scrubber private master 2025-04-22 b245058 dormant-2025
whisper private master 2025-04-22 8997fff dormant-2025
simple_task_manager public master 2025-04-20 ef67697 dormant-2025
projectX private master 2025-03-14 d9c09b0 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 2c55a0b dormant-2025
radio-streamer private master 2025-02-23 2c55a0b dormant-2025
playlist-maker private master 2025-02-22 4cac173 dormant-2025
scover public master 2025-02-22 c7a9768 dormant-2025
vec_search private master 2025-02-20 a0ee927 dormant-2025
yummspace public master 2025-02-17 a0ee927 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 d2e1add 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 4e69344 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 d3c2f52 old-2024
wpp-verif private master 2024-06-19 30becd1 old-2024
wplms_user_transport private master 2024-06-18 372c96 old-2024
home-web-panel private master 2024-06-06 1e68e09 old-2024
music-loader public master 2024-05-23 fbbef1 old-2024
gnexus-blog private master 2024-05-21 74f9da5 old-2024
gnexus-scope private master 2024-05-14 99b4f0 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.