All apps · 0 apps
Phoenixd
Docker app from Raccommode's Repository
Overview
Phoenixd is the server equivalent of the Phoenix self-custodial Bitcoin Lightning wallet. It runs a Phoenix node with automated liquidity management and exposes an HTTP API for balance, invoices, payments, exports, and webhooks.
Readme
View on GitHubphoenixd
phoenixd is the server equivalent of the popular phoenix wallet for mobile. It is written in Kotlin Multiplatform and runs natively on Linux (x86 and ARM), MacOS (x86 and ARM), and Windows (WSL).
Build
Requirements
Native Linux/WSL x64
./gradlew linuxX64DistZip
Native Linux arm64
./gradlew linuxArm64DistZip
Native MacOS x64
./gradlew macosX64DistZip
Native MacOS arm64
./gradlew macosArm64DistZip
JVM
./gradlew jvmDistZip
Requirements
Phoenixd is self-custodial and can custody real bitcoin. Back up seed.dat and phoenix.conf from the Data path before funding the wallet. Do not reuse the same seed with another Phoenix mobile or server instance. The HTTP API uses Basic Auth; the full-access and limited-access passwords are generated in phoenix.conf on first start, and can be edited there with phoenixd option names such as http-password, http-password-limited-access, webhook, auto-liquidity, max-mining-fee, and mempool-space-url. This template runs Phoenixd as root with --user=0:0 and HOME=/phoenix so Unraid data directories created with restrictive ownership are still writable and Phoenixd keeps using /phoenix/.phoenix. If you previously created the Data path with another user, run this once from an Unraid terminal before recreating the container: mkdir -p /mnt/user/bitcoin/phoenixd && chown -R 0:0 /mnt/user/bitcoin/phoenixd && chmod -R u+rwX /mnt/user/bitcoin/phoenixd
Categories
Download Statistics
9,388
Total Downloads
Related apps
Explore more like this
Explore allDetails
Repository
acinq/phoenixd:latestLast Updated2026-07-13
First Seen2026-05-19
Runtime arguments
- Network
bridge- Shell
bash- Privileged
- false
- Extra Params
--user=0:0
Template configuration
HTTP API PortPorttcp
Phoenixd HTTP API port. Container port: 9740. The API requires Basic Auth using the password generated in phoenix.conf.
- Target
- 9740
- Default
- 9740
- Value
- 9740
DataPathrw
Persistent wallet seed, phoenix.conf API passwords, channel database, payment database, logs, and exports. Keep this path writable by the container and back it up before funding the wallet.
- Target
- /phoenix/.phoenix
- Default
- /mnt/user/bitcoin/phoenixd
- Value
- /mnt/user/bitcoin/phoenixd
HomeVariable
Container home directory. Keep this set to /phoenix so Phoenixd writes to the mounted Data path at /phoenix/.phoenix.
- Target
- HOME
- Default
- /phoenix
- Value
- /phoenix