Phoenixd

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.

Kotlin License

phoenixd

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

Install Phoenixd on Unraid in a few clicks.

Find Phoenixd in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Phoenixd Review the template variables and paths Click Install

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

Download Statistics

4,847
Total Downloads

Related apps

Details

Repository
acinq/phoenixd:latest
Last Updated2026-05-25
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