summaryrefslogtreecommitdiff
path: root/doc/setup-guide.md
AgeCommit message (Collapse)Author
2026-03-04Add Authelia SSO, Jenkins OIDC, Gerrit HTTP auth, and related configArseney300
- authelia/: Full Authelia stack (docker-compose, config, setup guide, nginx snippet) - Forward-auth for Netdata, Cockpit, Nexus, registry - OIDC provider for Jenkins (oic-auth plugin, authorization_policy: one_factor) - HTTP header auth for Gerrit (X-Forwarded-User on /login/ only) - authelia_network: 172.26.0.0/16 - nginx/nginx.conf: - auth.swave.lol server block - /_authelia-auth internal subrequest locations (resolver 127.0.0.11) - auth_request on Gerrit /login/, Jenkins, Nexus, registry - OIDC finishLogin bypass for Jenkins - swave.lol/gerrit and swave.lol/jenkins redirect to subdomains - proxy_redirect for Gerrit container hostname rewrites - nginx/docker-compose.yaml: joined authelia_network - nginx/run_certbot.sh: added auth.swave.lol - jenkins/docker-compose.yaml: removed --prefix=/jenkins (Jenkins now at /) - cockpit/nginx-authelia.conf, netdata/nginx-netdata.conf: added auth_request - git-server/gerrit.config.example: Gerrit config template (real config gitignored) - .gitignore: added users_database.yml, gerrit.config - CLAUDE.md: updated Jenkins, Gerrit, Authelia entries; added key files - doc/setup-guide.md: Authelia section, updated startup order and service table Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-02Add Nexus Repository Manager with Docker registry and Authelia authArseney300
Nexus provides artifact storage (Maven, raw, etc.) and a private Docker registry at registry.swave.lol. Authelia forward-auth protects Gerrit, Jenkins, and Nexus behind SSO. Includes setup guide, nginx config, certbot domains, and a Jenkins pipeline example for artifact uploads. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02Add Cockpit & Netdata to setup guide and update nginx configArseney300
- Document Cockpit and Netdata setup in section 8 of setup guide - Add monitoring_network to nginx compose with host-gateway for Cockpit - Update network diagram, startup order, services table and ports summary - Minor CLAUDE.md Jenkins description improvements Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-21Add permanent build agent setup instructions to setup guideArseney300
Document how to add dedicated build agents via SSH, configure labels for routing jobs, and disable builds on the controller for scaling. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20Add pipeline durability fix and stuck build cleanup scriptArseney300
Mount jenkins/init.groovy.d/ into the container to auto-clean corrupted flow executions on startup (JENKINS-50407). Document both the prevention (Performance-optimized durability setting) and recovery (groovy cleanup script) in the setup guide. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20Add importing existing repositories to setup guideArseney300
Cover bare clone for one-time copies and mirror clone for keeping repos synced with an upstream source. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20Add git-server to jenkins_network with static IPsArseney300
Define subnet 172.23.0.0/16 for jenkins_network with static IPs: jenkins (172.23.0.2), git-server (172.23.0.3), gerrit (172.23.0.4). This allows git-server to communicate directly with Jenkins for build triggers and webhook integrations. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20Add Gerrit code review service to git-server stackArseney300
Gerrit joins git-network (repo access) and jenkins_network (build triggers), uses the official gerritcodereview/gerrit image with persistent storage under /var/gerrit, and is reverse-proxied via nginx at gerrit.swave.lol and swave.lol/gerrit. Updated certbot, setup guide, and project docs accordingly. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20Add chown step for jenkins_home in setup guideArseney300
Jenkins runs as UID 1000 and needs write access to /var/jenkins_home. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20Add cgit web interface to git-server stackArseney300
Adds a lightweight cgit container (Alpine + fcgiwrap + nginx) that auto-discovers bare repos via scan-path and serves them read-only. Accessible at both cgit.swave.lol and swave.lol/cgit through the main nginx reverse proxy. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20git-server: add in doc how to clone repo via gitArseney300
2026-02-20Update setup guide: use ed25519 keys for git serverArseney300
RSA keys are rejected by OpenSSH 10.0 in debian:latest due to dropped SHA-1 signature support. Ed25519 is the recommended key type. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20Add full server setup guideArseney300
Step-by-step instructions to build the bastion server from a fresh Debian install: Docker, Portainer, Git Server, Ghost, Jenkins, Nginx with SSL. Includes network architecture, startup order, and ports summary. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>