caoimhinr/pve_community
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
3 commits 1 branch 0 tags 33 KiB
Find a file
Exact
caoimhinr f6dc8e0970 Document the correct one-line installer 
Clarify that the OpenCode CT script already sources build.func so the published one-liner works without hitting argument length issues.
2026-04-12 21:05:56 +02:00
ct Move pve_community files to repo root 2026-04-12 20:46:06 +02:00
install Move pve_community files to repo root 2026-04-12 20:46:06 +02:00
AGENTS.md Move pve_community files to repo root 2026-04-12 20:46:06 +02:00
README.md Document the correct one-line installer 2026-04-12 21:05:56 +02:00

README.md

Personal Proxmox LXC Scripts

This repo is a small personal version of the community-scripts pattern:

  • ct/ contains host-side Proxmox creation scripts
  • install/ contains the in-container install logic

OpenCode LXC

ct/opencode.sh creates a Debian LXC and installs the opencode CLI for a normal user.

It now follows the upstream community-scripts host-side flow more closely, including the standard Default Install, Advanced Install, and User Defaults entry points.

What it does

  • picks a Debian 12 template from your configured Proxmox storages
  • creates an unprivileged LXC with sensible defaults for a coding box
  • installs common CLI tooling (git, ripgrep, fd, curl, build-essential)
  • installs OpenCode via the official installer
  • creates a writable /workspace directory owned by the opencode user
  • enables a systemd-managed OpenCode web interface on boot

Usage

Run on the Proxmox host as root:

bash ct/opencode.sh

Community-scripts style one-liner:

bash -c "$(curl -fsSL https://forgejo.welvaert.org/caoimhinr/pve_community/raw/branch/main/ct/opencode.sh)"

The previous two-step build.func wrapper is not needed here because ct/opencode.sh already downloads and sources build.func itself.

Example with overrides:

CTID=220 \
HOSTNAME=opencode-dev \
BRIDGE=vmbr1 \
CONTAINER_STORAGE=local-lvm \
TEMPLATE_STORAGE=local \
MEMORY=8192 \
CORES=4 \
DISK_GB=24 \
OPENCODE_USER=dev \
OPENCODE_WEB_PORT=4096 \
bash ct/opencode.sh

One-liner with overrides:

CTID=220 MEMORY=8192 CORES=4 DISK_GB=24 OPENCODE_USER=dev bash -c "$(curl -fsSL https://forgejo.welvaert.org/caoimhinr/pve_community/raw/branch/main/ct/opencode.sh)"

You can also use the upstream-style var_* overrides, for example var_cpu, var_ram, var_disk, var_brg, var_net, var_ctid, and var_hostname.

Common Variables

  • CTID default 120
  • HOSTNAME default opencode
  • CORES default 2
  • MEMORY default 4096
  • DISK_GB default 12
  • BRIDGE default vmbr0
  • IP_CONFIG default dhcp
  • TEMPLATE_STORAGE auto-selects first storage with vztmpl
  • CONTAINER_STORAGE auto-selects first storage with rootdir
  • OPENCODE_USER default opencode
  • OPENCODE_VERSION empty means latest release
  • OPENCODE_WEB_HOSTNAME default 0.0.0.0
  • OPENCODE_WEB_PORT default 4096
  • OPENCODE_SERVER_USERNAME default opencode
  • OPENCODE_SERVER_PASSWORD optional basic-auth password for the web UI
  • SSH_PUBLIC_KEY_FILE optional path to a host public key file to inject into the CT

Community-Scripts Behavior

  • supports the standard community-scripts settings flow on the Proxmox host
  • supports default.vars and app-default handling from the shared build.func base
  • still accepts the legacy environment variable names documented above for quick one-shot runs

After Creation

pct enter 120
su - opencode
opencode

The web interface is started automatically at boot and listens on http://<ct-ip>:4096 by default.

Then configure a provider inside OpenCode with /connect, or set your provider credentials manually.