wenil
cd2840fbb3
The whiptail helper added cognitive overhead without saving much time vs. the standard Proxmox web UI. Removed it from deploy/ and rewrote README + deploy/README to point at the manual flow: 1. Create LXC via Proxmox UI (Debian 12, 4c/8GB/32GB, nesting=1) 2. Inside: curl deploy/install.sh — provisions everything install.sh and update.sh stay (those are useful).
86 lines
3.8 KiB
Markdown
86 lines
3.8 KiB
Markdown
# Deploy
|
|
|
|
Two scripts here, plus the systemd unit.
|
|
|
|
| File | Where it runs | What it does |
|
|
|-------------------------------|--------------------------------|---------------------------------------------------------------------------|
|
|
| `install.sh` | inside a Debian/Ubuntu host | Clones the repo, sets up Python venv, installs deps, starts systemd unit. |
|
|
| `update.sh` | inside the LXC/VM/server | `git pull` + refresh Python deps + `systemctl restart`. |
|
|
| `busbar-designer.service` | systemd | Unit file template; install.sh substitutes paths/user/port. |
|
|
|
|
Both scripts are idempotent (safe to re-run) and use only stdlib + Debian-shipped tools.
|
|
|
|
> Want to create the LXC and provision it in one go? See the manual walk-through in the main `README.md` (Quick start / Deploy section). The earlier `proxmox-lxc.sh` whiptail helper was removed — the Proxmox web UI + this `install.sh` are simpler and easier to debug.
|
|
|
|
---
|
|
|
|
## Push to your Gitea (one time)
|
|
|
|
```bash
|
|
git remote add gitea https://gitea.example.com/me/busbar-designer.git
|
|
git push gitea main
|
|
```
|
|
|
|
If your Gitea uses a self-signed cert, set `GIT_SSL_NO_VERIFY=1` (or install the CA into the system trust store).
|
|
|
|
---
|
|
|
|
## Inside a Debian / Ubuntu host (LXC, VM, bare)
|
|
|
|
```bash
|
|
REPO_URL=https://gitea.example.com/me/busbar-designer.git \
|
|
bash -c "$(curl -fsSL https://gitea.example.com/me/busbar-designer/raw/branch/main/deploy/install.sh)"
|
|
```
|
|
|
|
Defaults: `/opt/busbar-designer`, user `busbar`, port `5000`. Override with `INSTALL_DIR`, `SVC_USER`, `PORT`.
|
|
|
|
What it installs:
|
|
- Debian packages: `git python3 python3-venv libgl1 libglu1-mesa libxrender1 libxext6 libsm6 libgomp1 openscad xvfb`
|
|
- Python venv with `build123d`, `Flask`, `ezdxf`, `gunicorn`
|
|
- systemd unit (substituted with your paths/user/port)
|
|
|
|
---
|
|
|
|
## Updating after `git push`
|
|
|
|
From the Proxmox host:
|
|
```bash
|
|
pct exec 210 -- bash /opt/busbar-designer/deploy/update.sh
|
|
```
|
|
|
|
Or SSH in and:
|
|
```bash
|
|
sudo bash /opt/busbar-designer/deploy/update.sh
|
|
```
|
|
|
|
Does `git fetch + reset --hard` on the tracked branch, refreshes Python deps, restarts the service.
|
|
|
|
---
|
|
|
|
## Backup & restore
|
|
|
|
All user data lives in `/opt/busbar-designer/data/busbar.db` (SQLite, single file).
|
|
|
|
```bash
|
|
# Backup (from Proxmox host)
|
|
pct exec 210 -- cat /opt/busbar-designer/data/busbar.db > busbar-backup-$(date +%F).db
|
|
|
|
# Restore
|
|
cat busbar-backup-2026-05-24.db | pct exec 210 -- bash -c \
|
|
'systemctl stop busbar-designer && cat > /opt/busbar-designer/data/busbar.db && chown busbar:busbar /opt/busbar-designer/data/busbar.db && systemctl start busbar-designer'
|
|
```
|
|
|
|
Or use Proxmox's own LXC backup (`vzdump`) which captures the whole rootfs (slower, captures everything).
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
| Symptom | Fix |
|
|
|--------------------------------------------------|---------------------------------------------------------------------------------------|
|
|
| Git clone fails with TLS error | Set `GIT_SSL_NO_VERIFY=1`, or install your Gitea CA cert into `/usr/local/share/ca-certificates`. |
|
|
| Service starts then dies | `journalctl -u busbar-designer -n 100`. Usually OCP wheel didn't install — check Python version. |
|
|
| `/api/holder/render` returns 500 | `which openscad`. If missing: `apt install -y openscad`. |
|
|
| Browser shows 502 / can't connect | Check IP with `hostname -I`. If DHCP, the IP may have changed. |
|
|
| Port 5000 already in use | Edit systemd unit: `Environment=PORT=5050` and `ExecStart=...--bind=0.0.0.0:5050`. |
|