Author SHA1 Message Date
libretech 8b3d53b3c5 docs(security): remove SSH username/host specifics from public docs 2026-05-02 14:43:14 +02:00
libretech 61f5133388 ci: trigger CI after runner-image registry auth fix 2026-05-02 12:58:51 +02:00
libretech 2b148e9531 fix(ci): correct image digest separator (@ not :) 2026-04-30 12:20:19 +02:00
libretech 6cf99ab280 ci: digest-pin runner-image v0.1.0 (was :v2)
Drops the ad-hoc :vN tag scheme — see runner-image#semver. Consumers
now reference tag + digest so the resolved image is byte-identical
across runs.
2026-04-30 12:17:34 +02:00
libretech 3ded11283b ci: update runner-image path to public/ namespace
The runner-image repo moved from libretech/ to public/ on Gitea;
ci.yml and deploy.yml + docs reference public/runner-image.
2026-04-30 11:53:41 +02:00
libretech 1374f55783 ci: pin runner-image v2 (adds gcc for cgo, fixes go test -race)
v1 lacked gcc, so 'go test -race' (in Makefile) failed in CI with
'go: -race requires cgo'. v2 of the runner image installs gcc,
libc6-dev, and pkg-config.
2026-04-30 00:17:05 +02:00
7 changed files with 2 additions and 99 deletions
+1 -1
View File
@@ -12,7 +12,7 @@ jobs:
# Bespoke runner image (Ubuntu 24.04 + make + git + node + go via # Bespoke runner image (Ubuntu 24.04 + make + git + node + go via
# actions/setup-go). See git.librete.ch/public/runner-image. # actions/setup-go). See git.librete.ch/public/runner-image.
container: container:
image: git.librete.ch/public/runner-image:v0.2.0@sha256:f60c587d3c0b0aac04a572db5349e27672bf76baec2ce547a3dcc28cebcf1b7e image: git.librete.ch/public/runner-image:v0.1.0@sha256:9d1e204fe8e06b7d16cdc8da0c7077fa4171daef62099cc8c09993834e576ca5
timeout-minutes: 5 timeout-minutes: 5
steps: steps:
- name: Checkout - name: Checkout
+1 -1
View File
@@ -34,7 +34,7 @@ jobs:
# + perl + ssh, runner user pre-joined to docker gid 998 so the # + perl + ssh, runner user pre-joined to docker gid 998 so the
# auto-mounted /var/run/docker.sock is writable without --user root. # auto-mounted /var/run/docker.sock is writable without --user root.
container: container:
image: git.librete.ch/public/runner-image:v0.2.0@sha256:f60c587d3c0b0aac04a572db5349e27672bf76baec2ce547a3dcc28cebcf1b7e image: git.librete.ch/public/runner-image:v0.1.0@sha256:9d1e204fe8e06b7d16cdc8da0c7077fa4171daef62099cc8c09993834e576ca5
timeout-minutes: 20 timeout-minutes: 20
if: ${{ vars.DEPLOY_ENABLED == 'true' }} if: ${{ vars.DEPLOY_ENABLED == 'true' }}
steps: steps:
-7
View File
@@ -15,10 +15,3 @@ wave.yaml
/dist/ /dist/
*.test *.test
*.out *.out
# Agent scratch
/.agents/
# runtime data and state of the stopped stack
/data/
/state/
-1
View File
@@ -1 +0,0 @@
See CLAUDE.md for project guidelines.
-82
View File
@@ -1,82 +0,0 @@
# Deploy runbook — librenotes
Derived from [`netcup/DEPLOY-TEMPLATE.md`](https://git.librete.ch/libretech/netcup/src/branch/main/DEPLOY-TEMPLATE.md).
Section ordering and headings stable across stacks.
## 1. Target
| Field | Value |
|-------|-------|
| Vhost | `ln.cloud.librete.ch` |
| Server path | `/srv/librenotes/` |
| Repo | `git.librete.ch/public/librenotes` |
| Image source | `${LIBRENOTES_IMAGE}` from `git.librete.ch/public/librenotes` (registry image, no source build on remote) |
| Cert | edge caddy via INWX DNS-01 |
| Edge net container name | `librenotes` (matches `caddy/Caddyfile` reverse_proxy target on `:8080`) |
## 2. Required env / secrets
`/srv/librenotes/.env` (gitignored, mode 0600):
| Variable | Notes |
|----------|-------|
| `LIBRENOTES_IMAGE` | published tag, e.g. `git.librete.ch/public/librenotes:v0.1.0` |
| `LIBRENOTES_BASE_URL` | `https://ln.cloud.librete.ch` |
| `LIBRENOTES_JWT_SECRET` | `openssl rand -base64 48` |
| `LIBRENOTES_SMTP_HOST`, `..._PORT`, `..._USER`, `..._PASS`, `..._FROM` | outbound mail (uberspace per `netcup/.env`) |
## 3. First-time deploy
```sh
ssh netcup 'docker network ls | grep -q edge || docker network create edge'
ssh netcup 'mkdir -p /srv && cd /srv && git clone ssh://tengo@git.librete.ch:41240/public/librenotes.git'
scp librenotes/.env netcup:/srv/librenotes/.env
ssh netcup 'chmod 600 /srv/librenotes/.env'
ssh netcup 'cd /srv/librenotes && docker compose -f compose.yaml -f compose.netcup.yaml pull && docker compose -f compose.yaml -f compose.netcup.yaml up -d'
```
## 4. Update deploy
```sh
deploy librenotes
# Bump LIBRENOTES_IMAGE in /srv/librenotes/.env then:
ssh netcup 'cd /srv/librenotes && docker compose -f compose.yaml -f compose.netcup.yaml pull && docker compose -f compose.yaml -f compose.netcup.yaml up -d'
```
## 5. Smoke / health
```sh
ping ln.cloud.librete.ch
cert ln.cloud.librete.ch
svcs librenotes
logs librenotes librenotes --tail=100
```
UI smoke: signup magic-link email arrives, login succeeds, note creation persists.
## 6. Logs + troubleshooting
| Symptom | First check |
|---------|-------------|
| 502 from edge | container off `edge` net or down |
| SMTP failure | `LIBRENOTES_SMTP_*` correct; firewall to uberspace |
| State loss | bind-mount `./state:/var/lib/librenotes` permissions |
## 7. Rollback
```sh
# Edit LIBRENOTES_IMAGE to prior tag in /srv/librenotes/.env, then:
ssh netcup 'cd /srv/librenotes && docker compose -f compose.yaml -f compose.netcup.yaml pull && docker compose -f compose.yaml -f compose.netcup.yaml up -d'
```
## 8. Stack-specific notes
- **Bind mounts** `./data:/data` (notes payload) and `./state:/var/lib/librenotes` (DB/state) — back up both.
- Multi-tenant by base URL — single image instance per tenant config.
- Image is published from `public/librenotes` CI; never builds on remote.
## 9. Issue tracking
- Deploy issues: `git.librete.ch/public/librenotes/issues`
- Cross-stack: `libretech/netcup`
- After every deploy: append to `netcup/deployments.md`.
-2
View File
@@ -7,8 +7,6 @@ Cloud-native, multi-tenant notes application. A fork of
authentication, per-user data isolation, sync, and PWA support so it can authentication, per-user data isolation, sync, and PWA support so it can
run as a hosted service at [librenot.es](https://librenot.es). run as a hosted service at [librenot.es](https://librenot.es).
> **Deploy / operate on netcup:** see [DEPLOY.md](DEPLOY.md) (canonical netcup runbook).
## Features ## Features
- Markdown notes with bi-directional links (Zettelkasten / evergreen notes) - Markdown notes with bi-directional links (Zettelkasten / evergreen notes)
-5
View File
@@ -48,10 +48,6 @@
--bind "$HOME/.claude" "$HOME/.claude" --bind "$HOME/.claude" "$HOME/.claude"
--bind "$HOME/.claude.json" "$HOME/.claude.json" --bind "$HOME/.claude.json" "$HOME/.claude.json"
# Writable: GPG keyring + agent socket (commit signing)
--bind "$HOME/.gnupg" "$HOME/.gnupg"
--bind-try "''${XDG_RUNTIME_DIR:-/run/user/$(id -u)}/gnupg" "''${XDG_RUNTIME_DIR:-/run/user/$(id -u)}/gnupg"
--ro-bind "$HOME/.gitconfig" "$HOME/.gitconfig" --ro-bind "$HOME/.gitconfig" "$HOME/.gitconfig"
--ro-bind "$HOME/.ssh" "$HOME/.ssh" --ro-bind "$HOME/.ssh" "$HOME/.ssh"
--setenv GIT_SSH_COMMAND "ssh -F ~/.ssh/config" --setenv GIT_SSH_COMMAND "ssh -F ~/.ssh/config"
@@ -65,7 +61,6 @@
--setenv PATH "$PATH" --setenv PATH "$PATH"
--setenv TERM "''${TERM:-xterm}" --setenv TERM "''${TERM:-xterm}"
--setenv SANDBOX_ACTIVE "1" --setenv SANDBOX_ACTIVE "1"
--setenv GPG_TTY "''${GPG_TTY:-}"
--chdir "$PROJECT_DIR" --chdir "$PROJECT_DIR"
) )