pve_community/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
bash ct/opencode.sh
```

Community-scripts style one-liner:

```bash
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:

```bash
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:

```bash
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

```bash
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.