archipelagoandClaude Opus 5
eb48eab946
Nodes offer an update when the signed catalog pins something newer than what's running, and that machinery is fine. The missing step was the one before it: nothing told *us* when upstream shipped. A pin could sit at fedimintd v0.10.0 for months while every node in the fleet correctly and confidently reported "up to date". The reason nothing could tell us is that a manifest records only our mirror — `source.archipelago-foundation.org/lfg2025/fedimintd:v0.10.0` says nothing about the project it was mirrored from. So this adds an optional `app.upstream` block naming the real source, and a script that asks each one what it has released. Running it answers the question that prompted this. Of 58 apps, 28 are behind, including LND v0.18.4-beta against v0.21.2-beta, Bitcoin Core 28.4 against 31.1, and fedimintd/gatewayd v0.10.0 against v0.10.1. Two choices worth stating. An app with no `upstream` block is reported as UNTRACKED rather than skipped — a silent skip is how this stayed invisible, and before this commit all 58 were silently skipped. And a suggestion prefers our own tag variant: telling someone pinned to `postgres:16.13-alpine` that the newest tag is `18.6-trixie` is true and useless, because swapping the base image is a different decision from bumping a version. Five apps are deliberately left untracked (barkd, immich-postgres, indeedhub-minio, lightning-stack, pine-whisper): I could not establish their upstream with confidence, and a wrong `repo` produces a confident wrong verdict, which is worse than an honest gap. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
82 lines
2.8 KiB
YAML
82 lines
2.8 KiB
YAML
app:
|
|
id: phoenixd
|
|
name: phoenixd
|
|
version: 0.9.0
|
|
# Where this app comes from, so scripts/check-upstream-releases.py can
|
|
# tell us when the pin below has fallen behind. Without it nothing can:
|
|
# container.image names our mirror, not the project it was mirrored from.
|
|
upstream:
|
|
kind: github
|
|
repo: ACINQ/phoenixd
|
|
description: Headless Lightning daemon by ACINQ (the Phoenix wallet team). No screen of its own — it exposes a small local API that other apps and tools use to send and receive Lightning payments. Channel liquidity is managed automatically for a fee.
|
|
category: money
|
|
|
|
container:
|
|
# Image entrypoint already runs with --agree-to-terms-of-service and
|
|
# --http-bind-ip 0.0.0.0, as user "phoenix"; no custom args needed.
|
|
image: source.archipelago-foundation.org/lfg2025/phoenixd:0.9.0
|
|
pull_policy: if-not-present
|
|
# The image runs as user phoenix (1000:1000); the datadir bind source
|
|
# must be chowned to that identity or phoenixd dies on
|
|
# "Failed to open /data/phoenix.conf with Permission denied".
|
|
data_uid: "1000:1000"
|
|
|
|
dependencies:
|
|
- storage: 500Mi
|
|
|
|
resources:
|
|
cpu_limit: 1
|
|
memory_limit: 512Mi
|
|
disk_limit: 1Gi
|
|
|
|
security:
|
|
capabilities: []
|
|
readonly_root: true
|
|
no_new_privileges: true
|
|
network_policy: bridge
|
|
|
|
ports:
|
|
- host: 9740
|
|
container: 9740
|
|
protocol: tcp
|
|
bind: 127.0.0.1
|
|
auth: none
|
|
auth_rationale: >-
|
|
Loopback-only JSON API, not a web page. Every request is
|
|
authenticated by the http password phoenixd generates in its own
|
|
data directory on first run; the app gate's browser login page
|
|
would break the API clients this port exists for.
|
|
|
|
volumes:
|
|
# The wallet seed (seed.dat) and phoenix.conf live here. This directory
|
|
# must survive reinstall/migration like any other app data dir —
|
|
# losing it means losing funds.
|
|
# Target is /data (via PHOENIX_DATADIR below), NOT the image's default
|
|
# /phoenix/.phoenix: the orchestrator treats any bind path containing a
|
|
# dot as a file mount and skips creating its source directory, so a
|
|
# hidden-dir target never gets its host dir and the unit crash-loops.
|
|
- type: bind
|
|
source: /var/lib/archipelago/phoenixd
|
|
target: /data
|
|
options: [rw]
|
|
|
|
environment:
|
|
- PHOENIX_DATADIR=/data
|
|
|
|
health_check:
|
|
type: tcp
|
|
endpoint: localhost:9740
|
|
interval: 30s
|
|
timeout: 5s
|
|
retries: 5
|
|
|
|
metadata:
|
|
icon: /assets/img/app-icons/phoenixd.svg
|
|
repo: https://github.com/ACINQ/phoenixd
|
|
tier: optional
|
|
features:
|
|
- Ultra-light Lightning node — no bitcoin node required
|
|
- Automated channel and liquidity management (fees apply)
|
|
- Simple HTTP API + websockets for payments
|
|
- Backed by the team behind the Phoenix mobile wallet
|