Skip to content

feat(template): add File Browser workspace app - #928

Merged
ppat merged 2 commits into
mainfrom
feat/filebrowser-sidecar
Sep 16, 2026
Merged

ppat merged 2 commits into
mainfrom
feat/filebrowser-sidecar

Conversation

@homelab-agent-bot

@homelab-agent-bot homelab-agent-bot Bot commented Sep 16, 2026 •

Copy link
Copy Markdown
Contributor

What

  • add a dedicated Coder agent and owner-only Files application for File Browser Quantum
  • run the upstream, digest-pinned image as a sidecar whose PID 1 is the Coder agent and whose startup script launches File Browser
  • mount the selected home PVC's workspace subdirectory at /srv
  • supply File Browser configuration through the workspace ConfigMap while keeping its generated database on ephemeral storage

Why

File Browser needs to see the same persistent files as the main workspace without becoming a separately exposed Kubernetes service. The Coder agent supplies the transport and authentication boundary, and a subdomain app preserves File Browser's root-relative routing.

The sidecar uses the workspace UID/GID so files created with ordinary owner-only write permissions remain editable from either container. Its own mutable database is intentionally ephemeral; authentication and reachability belong to Coder, while the durable content remains exclusively on the selected home PVC.

Validation

  • pre-commit run --all-files
  • tofu validate
  • tflint --config=../../../.tflint.hcl
  • upstream image smoke test as UID/GID 10001 with the mounted configuration and home directory
  • independent subagent review, including a permission-boundary correction and clean re-review

Dependency

Stacked on PR #930, which makes the existing readiness check select the primary agent explicitly.

The stacked workflow PR adds runtime coverage for the sidecar, shared storage, and proxied UI.

@homelab-agent-bot
homelab-agent-bot Bot force-pushed the feat/filebrowser-sidecar branch from 19e1be7 to fecb6e2 Compare September 16, 2026 22:32
@homelab-agent-bot
homelab-agent-bot Bot changed the base branch from main to ci/select-main-agent September 16, 2026 22:32
@homelab-agent-bot
homelab-agent-bot Bot force-pushed the feat/filebrowser-sidecar branch from fecb6e2 to 348b244 Compare September 16, 2026 22:40
@homelab-agent-bot
homelab-agent-bot Bot force-pushed the feat/filebrowser-sidecar branch 6 times, most recently from 84c571d to bc16284 Compare September 16, 2026 23:26
Base automatically changed from ci/select-main-agent to main September 16, 2026 23:37
@homelab-agent-bot
homelab-agent-bot Bot force-pushed the feat/filebrowser-sidecar branch from bc16284 to a479726 Compare September 16, 2026 23:38
Comment thread templates/kubernetes/homelab-workspace/deployment.tf Outdated
@ppat
ppat merged commit 4ee1905 into main Sep 16, 2026
15 of 16 checks passed
@ppat
ppat deleted the feat/filebrowser-sidecar branch September 16, 2026 23:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant