Alpine Setup

The setup script bootstraps Bash when necessary, installs AppWeaver's system and user dependencies, downloads the default Piper voice, installs the project packages, and configures Caddy using the machine's reverse DNS hostname.

Before running it, ensure:

Preserve /var/lib/caddy between reinstalls (see Backup Caddy certificates). It contains the ACME account and issued certificates. Good for rate limits.
The current user can run doas commands, or run the script as root.
The server has a reverse DNS record pointing to its public IPv4 address.
Inbound TCP ports 80 and 443 are open.

Backup Caddy certificates

Caddy stores its ACME account and TLS certificates under /var/lib/caddy/. Back this up before reinstalling the server or moving to a new machine to avoid Let's Encrypt rate limits.

On the Alpine server, create an archive:

doas tar czf /tmp/caddy-backup.tgz -C /var/lib caddy
doas chown "$(id -un):$(id -gn)" /tmp/caddy-backup.tgz

From your local machine, download it with scp:

scp -i ~/.ssh/lnvps_ed25519 \
  alpine@<reverse-dns-hostname>:/tmp/caddy-backup.tgz \
  ~/backups/caddy-backup.tgz

To restore after a reinstall, upload the archive and extract it before running the setup script:

scp -i ~/.ssh/lnvps_ed25519 \
  ~/backups/caddy-backup.tgz \
  alpine@<reverse-dns-hostname>:/tmp/caddy-backup.tgz

doas tar xzf /tmp/caddy-backup.tgz -C /var/lib
doas chown -R caddy:caddy /var/lib/caddy

Install

Run these commands on a fresh Alpine Linux server:

doas apk add git
mkdir my-workspace && cd my-workspace
git clone --depth=1 https://github.com/getappweaver/core.git appweaver
cd appweaver
./scripts/alpine-setup.sh

The script is safe to rerun. It updates existing AppWeaver settings instead of adding duplicate entries to .env or ~/.profile.

OpenCode Authentication

The setup script configures the Alpine SSH server to allow OpenCode's browser authentication callback on port 1455. Before starting AppWeaver, run this in a separate terminal on your local machine:

ssh -i ~/.ssh/lnvps_ed25519 \
  -o ExitOnForwardFailure=yes \
  -N \
  -L 127.0.0.1:1455:127.0.0.1:1455 \
  alpine@<reverse-dns-hostname>

Keep this command running until authentication finishes.

Run

Back in the Alpine SSH session, start AppWeaver:

. "$HOME/.profile"
bun run scripts/run-start.ts --host 127.0.0.1

Setup

Open the HTTPS setup URL printed by AppWeaver. OpenCode authentication is handled by the setup page.

https://<reverse-dns-hostname>/setup?secret=<generated-secret>