admin/felhom-controller
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: rework references for repo rename deploy-felhom-compose -> felhom-controller

Browse Source 
Repo renamed on Gitea (admin/deploy-felhom-compose -> admin/felhom-controller).
Updates clone URLs, clone dirs, the customer bootstrap URL, build.sh, BUILDING.md,
README.md, CLAUDE.md, CONTEXT.md and TASK.md to the new name. No functional change:
Go module path and Docker image path (both already 'felhom-controller') untouched.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
authentik Default Admin
2026-06-08 13:38:27 +02:00
parent a54ec5a598
commit e9ca42060c
9 changed files with 25 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CHANGELOG.md
+7
View File
@@ -1,5 +1,12 @@
## Changelog ## Changelog
### Repo rename — `deploy-felhom-compose` → `felhom-controller` (2026-06-08)
#### Changed
- **Gitea repo renamed** `admin/deploy-felhom-compose` → `admin/felhom-controller` (via API). Sibling rename: `admin/proxmox-controller` → `admin/felhom-agent` (docs repo, future agent code).
- **Reference rework (no functional change)**: updated every reference to the old repo name across docs and scripts — clone URLs, clone dirs (`~/git/felhom-controller`), the customer bootstrap URL in `scripts/felhom-wipe.sh` / `scripts/README.md`, `controller/build.sh`, `controller/BUILDING.md`, `controller/README.md`, `CLAUDE.md`, `CONTEXT.md`, `TASK.md`. Local working-copy dirs and the build-server source clone (`192.168.0.180:~/git/`) renamed to match.
- **Intentionally unchanged**: Go module path `gitea.dooplex.hu/admin/felhom-controller` (already matches new name), Docker image path `gitea.dooplex.hu/admin/felhom-controller` (registry is namespaced by owner, not repo), binary name `felhom-controller`. Historical CHANGELOG entries left as-is (they record what was true at the time).
### Refactor — extract app-data-backup primitives into `internal/appbackup` (no behaviour change) (2026-06-08) ### Refactor — extract app-data-backup primitives into `internal/appbackup` (no behaviour change) (2026-06-08)
#### Changed #### Changed
CLAUDE.md
+4 -4
View File
@@ -12,7 +12,7 @@
## Project overview ## Project overview
Creating a business (Felhom) for home-server deployment for Hungarian customers. This repository Creating a business (Felhom) for home-server deployment for Hungarian customers. This repository
(`deploy-felhom-compose`) contains the felhom-controller — a Go application that manages Docker (`felhom-controller`) contains the felhom-controller — a Go application that manages Docker
Compose stacks on customer hardware via a Hungarian-language web dashboard. Compose stacks on customer hardware via a Hungarian-language web dashboard.
See `controller/README.md` for full architecture and status (update after each session, keep track of how different functions/features operate, like backup, monitoring, storage handling, app management, user settings, update workflow, notification system, etc-etc...). See `controller/README.md` for full architecture and status (update after each session, keep track of how different functions/features operate, like backup, monitoring, storage handling, app management, user settings, update workflow, notification system, etc-etc...).
@@ -44,7 +44,7 @@ Claude Code runs on Windows 11. The working directory is `E:\git\` (mapped as `/
This repo is at: This repo is at:
``` ```
E:\git\deploy-felhom-compose\ (or /e/git/deploy-felhom-compose/ in Git Bash) E:\git\felhom-controller\ (or /e/git/felhom-controller/ in Git Bash)
├── controller/ # Go application (main codebase) ├── controller/ # Go application (main codebase)
│ ├── cmd/controller/ # Entry point (main.go) │ ├── cmd/controller/ # Entry point (main.go)
│ ├── internal/ │ ├── internal/
@@ -123,7 +123,7 @@ Do NOT leave code changes uncommitted or undeployed. The full cycle is:
### Step 1: Commit and push changes ### Step 1: Commit and push changes
```bash ```bash
cd /e/git/deploy-felhom-compose cd /e/git/felhom-controller
git add -A && git commit -m "<descriptive message>" && git push git add -A && git commit -m "<descriptive message>" && git push
``` ```
@@ -146,7 +146,7 @@ $SSH kisfenyo@192.168.0.162 "docker ps --filter name=felhom-controller --format
Then build with the next version (e.g., if current is 0.2.10, use 0.2.11): Then build with the next version (e.g., if current is 0.2.10, use 0.2.11):
IMPORTANT!: Build directory is: ~/build/felhom-controller IMPORTANT!: Build directory is: ~/build/felhom-controller
```bash ```bash
$SSH kisfenyo@192.168.0.180 "cd ~/build/felhom-controller && git -C ~/git/deploy-felhom-compose pull && ./build.sh <NEW_VERSION> --push" $SSH kisfenyo@192.168.0.180 "cd ~/build/felhom-controller && git -C ~/git/felhom-controller pull && ./build.sh <NEW_VERSION> --push"
``` ```
The build script: The build script:
CONTEXT.md
+1 -1
View File
@@ -124,7 +124,7 @@ Last updated: 2026-02-19 (session 59)
| Repository | Status | Notes | | Repository | Status | Notes |
|------------|--------|-------| |------------|--------|-------|
| deploy-felhom-compose | Active | This repo. Controller code + deploy scripts | | felhom-controller | Active | This repo. Controller code + deploy scripts |
| app-catalog-felhom.eu | Active | 10 app templates, all with .felhom.yml metadata + memory limits | | app-catalog-felhom.eu | Active | 10 app templates, all with .felhom.yml metadata + memory limits |
| felhom.eu | Active | Website + hub/ subfolder (felhom-hub service) + k8s manifests | | felhom.eu | Active | Website + hub/ subfolder (felhom-hub service) + k8s manifests |
| homelab-manifests | Stable | k3s cluster running (dooplex.hu services) | | homelab-manifests | Stable | k3s cluster running (dooplex.hu services) |
TASK.md
+1 -1
View File
@@ -331,7 +331,7 @@ After deployment:
```bash ```bash
SSH=/c/Windows/System32/OpenSSH/ssh.exe SSH=/c/Windows/System32/OpenSSH/ssh.exe
# After committing and pushing: # After committing and pushing:
$SSH kisfenyo@192.168.0.180 "cd ~/build/felhom-controller && git -C ~/git/deploy-felhom-compose pull && ./build.sh v0.28.0 --push" $SSH kisfenyo@192.168.0.180 "cd ~/build/felhom-controller && git -C ~/git/felhom-controller pull && ./build.sh v0.28.0 --push"
$SSH kisfenyo@192.168.0.162 "cd /opt/docker/felhom-controller && sudo docker pull gitea.dooplex.hu/admin/felhom-controller:v0.28.0 && sudo sed -i 's|image: gitea.dooplex.hu/admin/felhom-controller:.*|image: gitea.dooplex.hu/admin/felhom-controller:v0.28.0|' docker-compose.yml && sudo docker compose up -d" $SSH kisfenyo@192.168.0.162 "cd /opt/docker/felhom-controller && sudo docker pull gitea.dooplex.hu/admin/felhom-controller:v0.28.0 && sudo sed -i 's|image: gitea.dooplex.hu/admin/felhom-controller:.*|image: gitea.dooplex.hu/admin/felhom-controller:v0.28.0|' docker-compose.yml && sudo docker compose up -d"
``` ```
controller/BUILDING.md
+6 -6
View File
@@ -2,10 +2,10 @@
## Repository layout ## Repository layout
Source lives in the `controller/` subfolder of the deploy-felhom-compose repo: Source lives in the `controller/` subfolder of the felhom-controller repo:
``` ```
https://gitea.dooplex.hu/admin/deploy-felhom-compose https://gitea.dooplex.hu/admin/felhom-controller
└── controller/ └── controller/
├── cmd/controller/main.go ├── cmd/controller/main.go
├── internal/ ├── internal/
@@ -26,7 +26,7 @@ are flat in `controller/`, run the restructure script first (see Step 0).
## Build setup ## Build setup
Git repo: `/home/kisfenyo/git/deploy-felhom-compose` Git repo: `/home/kisfenyo/git/felhom-controller`
Build dir: `/home/kisfenyo/build/felhom-controller/` (outside the repo — keeps it clean) Build dir: `/home/kisfenyo/build/felhom-controller/` (outside the repo — keeps it clean)
```bash ```bash
@@ -41,7 +41,7 @@ chmod +x ~/build/felhom-controller/build.sh
If all `.go` files are in `controller/` without subdirectories: If all `.go` files are in `controller/` without subdirectories:
```bash ```bash
cd ~/git/deploy-felhom-compose/controller cd ~/git/felhom-controller/controller
bash restructure.sh bash restructure.sh
# Verify it compiles # Verify it compiles
go mod tidy && go build ./cmd/controller/ go mod tidy && go build ./cmd/controller/
@@ -107,7 +107,7 @@ Build artifacts live in `~/build/felhom-controller/workspace/` — your git repo
Edit the top of `build.sh` if your paths differ: Edit the top of `build.sh` if your paths differ:
```bash ```bash
REPO_DIR="/home/kisfenyo/git/deploy-felhom-compose" REPO_DIR="/home/kisfenyo/git/felhom-controller"
CONTROLLER_SRC="${REPO_DIR}/controller" CONTROLLER_SRC="${REPO_DIR}/controller"
WEBSITE_ASSETS_DIR="/home/kisfenyo/git/felhom.eu/website/assets" WEBSITE_ASSETS_DIR="/home/kisfenyo/git/felhom.eu/website/assets"
``` ```
@@ -183,7 +183,7 @@ curl -v https://gitea.dooplex.hu/v2/
### Structure check fails ### Structure check fails
```bash ```bash
# The build script verifies package dirs exist. If it fails: # The build script verifies package dirs exist. If it fails:
cd ~/git/deploy-felhom-compose/controller cd ~/git/felhom-controller/controller
ls -la cmd/controller/ internal/config/ internal/stacks/ internal/api/ internal/web/ ls -la cmd/controller/ internal/config/ internal/stacks/ internal/api/ internal/web/
# If these don't exist, run restructure.sh first # If these don't exist, run restructure.sh first
``` ```
controller/README.md
+2 -2
View File
@@ -1730,7 +1730,7 @@ Response format: `{"ok": true/false, "data": ..., "error": "...", "message": "..
```bash ```bash
# On build server (192.168.0.180) # On build server (192.168.0.180)
cd ~/build/felhom-controller cd ~/build/felhom-controller
git -C ~/git/deploy-felhom-compose pull git -C ~/git/felhom-controller pull
./build.sh v0.20.0 --push ./build.sh v0.20.0 --push
``` ```
@@ -1828,6 +1828,6 @@ See `docker-compose.yml` for the full volume configuration.
| Repository | Purpose | | Repository | Purpose |
|------------|---------| |------------|---------|
| [deploy-felhom-compose](https://gitea.dooplex.hu/admin/deploy-felhom-compose) | This repo — controller + deploy scripts | | [felhom-controller](https://gitea.dooplex.hu/admin/felhom-controller) | This repo — controller + deploy scripts |
| [app-catalog-felhom.eu](https://gitea.dooplex.hu/admin/app-catalog-felhom.eu) | Docker Compose templates + .felhom.yml metadata | | [app-catalog-felhom.eu](https://gitea.dooplex.hu/admin/app-catalog-felhom.eu) | Docker Compose templates + .felhom.yml metadata |
| [felhom.eu](https://gitea.dooplex.hu/admin/felhom.eu) | Website + app assets + felhom-hub service | | [felhom.eu](https://gitea.dooplex.hu/admin/felhom.eu) | Website + app assets + felhom-hub service |
controller/build.sh
+2 -2
View File
@@ -16,7 +16,7 @@
set -euo pipefail set -euo pipefail
# --- Configuration (edit these if your paths differ) --- # --- Configuration (edit these if your paths differ) ---
REPO_DIR="/home/kisfenyo/git/deploy-felhom-compose" REPO_DIR="/home/kisfenyo/git/felhom-controller"
CONTROLLER_SRC="${REPO_DIR}/controller" CONTROLLER_SRC="${REPO_DIR}/controller"
WEBSITE_ASSETS_DIR="/home/kisfenyo/git/felhom.eu/website/assets" WEBSITE_ASSETS_DIR="/home/kisfenyo/git/felhom.eu/website/assets"
REGISTRY="gitea.dooplex.hu/admin" REGISTRY="gitea.dooplex.hu/admin"
@@ -40,7 +40,7 @@ step() { echo -e "${CYAN}[STEP]${NC} $*"; }
# --- Pre-flight checks --- # --- Pre-flight checks ---
if [[ ! -d "${CONTROLLER_SRC}" ]]; then if [[ ! -d "${CONTROLLER_SRC}" ]]; then
error "Controller source not found: ${CONTROLLER_SRC}" error "Controller source not found: ${CONTROLLER_SRC}"
error "Clone the repo first: git clone https://gitea.dooplex.hu/admin/deploy-felhom-compose.git ${REPO_DIR}" error "Clone the repo first: git clone https://gitea.dooplex.hu/admin/felhom-controller.git ${REPO_DIR}"
exit 1 exit 1
fi fi
scripts/README.md
+1 -1
View File
@@ -304,5 +304,5 @@ wizard to temporarily inspect drives. It is cleaned up from `full` level onwards
### Redeploy after nuclear wipe ### Redeploy after nuclear wipe
```bash ```bash
curl -fsSL https://gitea.dooplex.hu/admin/deploy-felhom-compose/raw/branch/main/scripts/docker-setup.sh | bash curl -fsSL https://gitea.dooplex.hu/admin/felhom-controller/raw/branch/main/scripts/docker-setup.sh | bash
``` ```
scripts/felhom-wipe.sh
+1 -1
View File
@@ -484,7 +484,7 @@ do_nuclear_wipe() {
echo "" echo ""
info "Nuclear wipe complete." info "Nuclear wipe complete."
echo -e "${CYAN}To redeploy, run:${NC}" echo -e "${CYAN}To redeploy, run:${NC}"
echo " curl -fsSL https://gitea.dooplex.hu/admin/deploy-felhom-compose/raw/branch/main/scripts/docker-setup.sh | bash" echo " curl -fsSL https://gitea.dooplex.hu/admin/felhom-controller/raw/branch/main/scripts/docker-setup.sh | bash"
} }
# --- Main --- # --- Main ---