Skip to content

docs(website): Running Paddock on Proxmox (LXC) guide (#414) - #446

Merged
edspencer merged 1 commit into
mainfrom
docs/proxmox-lxc-guide-414
Jul 24, 2026
Merged

docs(website): Running Paddock on Proxmox (LXC) guide (#414)#446
edspencer merged 1 commit into
mainfrom
docs/proxmox-lxc-guide-414

Conversation

@edspencer

Copy link
Copy Markdown
Owner

Part of #405. Closes #414.

Adds website/src/content/docs/guides/proxmox-lxc.md — a bridge guide between the generic Deploying guide and the home-lab narrative, showing both LXC deploy paths. Verified against the merged docker/ and proxmox-iac/ recipes in paddock-deploy.

What's covered

  • Create an unprivileged Debian LXC — via the Proxmox UI, via pct, and via the proxmox-iac/ OpenTofu module. Notes features nesting=1,keyctl=1 for the Docker/devbox case inside an unprivileged container.
  • Path A — docker run inside the LXC (simplest) → links paddock-deploy/docker/.
  • Path B — tarball + systemd (no Docker), infra-as-code with OpenTofu + Ansible (dev box + home box) → links paddock-deploy/proxmox-iac/.
  • Auth at the edge → links the Securing guide + the auth-basic/ Tier-1 sidecar recipe.
  • Safe-by-default bind127.0.0.1 default + PADDOCK_DANGEROUSLY_ALLOW_OPEN for the container case.
  • Cross-links the paddock-deploy repo.

Scope

🤖 Generated with Claude Code

Bridge guide between the generic Deploying guide and the home-lab
narrative, showing both LXC deploy paths, verified against the merged
paddock-deploy docker/ and proxmox-iac/ recipes:

- Create an unprivileged Debian LXC via UI / pct / the proxmox-iac Tofu
  module, incl. features nesting=1,keyctl=1 for Docker/devbox.
- Path A: docker run inside the LXC (paddock-deploy/docker/).
- Path B: tarball + systemd via OpenTofu + Ansible
  (paddock-deploy/proxmox-iac/) with dev + home boxes.
- Auth at the edge: Securing guide + auth-basic/ Tier-1 sidecar.
- Safe-by-default loopback bind + PADDOCK_DANGEROUSLY_ALLOW_OPEN.

Sidebar wiring is #416, not touched here.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying paddock with  Cloudflare Pages  Cloudflare Pages

Latest commit: 47ecd58
Status: ✅  Deploy successful!
Preview URL: https://aba29bd2.paddock-7u2.pages.dev
Branch Preview URL: https://docs-proxmox-lxc-guide-414.paddock-7u2.pages.dev

View logs

@edspencer
edspencer merged commit e4d6eb3 into main Jul 24, 2026
4 checks passed
@edspencer
edspencer deleted the docs/proxmox-lxc-guide-414 branch July 24, 2026 01:57
@github-actions github-actions Bot mentioned this pull request Jul 24, 2026
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.

Docs: "Running Paddock on Proxmox (LXC)" guide (docker-run + tarball/systemd)

1 participant