# For Linux x86_64 # Replace with the latest release wget https://github.com/ACINQ/phoenixd/releases/download/v0.6.1/phoenixd-0.6.1-linux-x64.zip unzip -j phoenixd-0.6.1-linux-x64.zip chmod +x phoenixd phoenix-cli
./phoenixd
This software is self-custodial, you have full control and responsibility over your funds. Your 12-words seed is located in /home/<user>/.phoenix, make sure to do a backup or you risk losing your funds. Do not share the same seed with other phoenix instances (mobile or server), it will cause issues and channel force closes.
Continuous liquidity Liquidity management is fully automated. When receiving a Lightning payment that doesn't fit in your existing channel: - If the payment amount is large enough to cover mining fees and service fees for automated liquidity, then your channel will be created or enlarged right away. - If the payment is too small, then the full amount is added to your fee credit, and will be used later to pay for future fees. The fee credit is non-refundable.
PierreI understand for each confirmation.sudo nano /etc/systemd/system/phoenixd.service
[Unit] Description=Phoenixd - Minimalist Lightning node After=network.target [Service] User=your_user WorkingDirectory=/home/your_user ExecStart=/home/your_user/phoenixd Restart=on-failure RestartSec=5 [Install] WantedBy=multi-user.target
sudo systemctl daemon-reload sudo systemctl enable phoenixd sudo systemctl start phoenixd
auto-liquidity at 2m sat~/.phoenix/phoenix.conf with the essential parameters:# Network (mainnet by default) chain=mainnet # Size of automatic channels and requested liquidity amount (in satoshis) auto-liquidity=2000000 # API configuration http-bind-address=127.0.0.1 http-bind-port=9740 http-password=auto_generated_password http-password-limited-access=limited_password
auto-liquidity: Size of automatically opened channels (default: 2M Sats)http://127.0.0.1:9740). To use your node from outside (mobile applications, other servers, web integrations), you need to configure secure HTTPS access.Internet → nginx (port 443 HTTPS) → Phoenixd (port 9740 HTTP local)
sudo apt install nginx certbot python3-certbot-nginx sudo nano /etc/nginx/sites-available/phoenixd.conf
server { listen 80; server_name phoenixd.your-domain.com; location / { proxy_pass http://127.0.0.1:9740; proxy_set_header X-Real-IP $remote_addr; proxy_set_header Host $host; } }
sudo ln -s /etc/nginx/sites-available/phoenixd.conf /etc/nginx/sites-enabled/ sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d phoenixd.your-domain.com
./phoenix-cli getinfo ./phoenix-cli getbalance
curl -X POST http://localhost:9740/createinvoice \ -u :your_password \ -d description='First test' \ -d amountSat=100000
# Payment received: 100,000 sats # Channel created: 2,115,000 sats total capacity # Liquidity fee: 24,439 sats # Final balance: 75,561 sats
# View details of all channels ./phoenix-cli listchannels # Important output: # "toLocal": 75561000 (your balance in milli-sats) # "toRemote": 2039439000 (ACINQ's balance) # Total channel: 2,115,000 sats
journalctl -u phoenixd -f
./phoenix-cli listchannels
# Create an invoice curl -X POST http://localhost:9740/createinvoice \ -u :your_password \ -d description='Test payment' \ -d amountSat=100000 # Send a payment (routing fee 0.4%) curl -X POST http://localhost:9740/payinvoice \ -u :your_password \ -d invoice='lnbc...' # Check balance curl http://localhost:9740/getbalance \ -u :your_password # Send on-chain funds (in case of channel closure) ./phoenix-cli sendtoaddress \ --address bc1q... \ --amountSat 50000 \ --feerateSatByte 12
phoenix.conf :webhook-url=https://your-app.com/webhook-phoenixd webhook-secret=votre_secret_de_verification
curl -X POST http://localhost:9740/lnurlpay \ -u :your_password \ -d lnurl=LNURL1DP68GURN8GHJ7MRWW4EXCTN... \ -d amountSat=100
curl -X POST http://localhost:9740/lnurlwithdraw \ -u :your_password \ -d lnurl=lightning:LNURL1DP68GURN8GHJ7MRW...
curl -X POST http://localhost:9740/lnurlauth \ -u :your_password \ -d lnurl=lnurl1dp68gurn8ghj7um5v93kket...
LNBITS_BACKEND_WALLET_CLASS=PhoenixdWallet PHOENIXD_API_ENDPOINT=http://localhost:9740/ PHOENIXD_API_PASSWORD=your_password_phoenixd
journalctl -u phoenixd -f # Real-time logs ./phoenix-cli getinfo # Node status
~/.phoenix/phoenix.conf-u:password./phoenix-CLI getinfo)journalctl -u phoenixd -fThis tutorial has been written by Pierre
You can say thanks by tipping the professor.
Passionate about Bitcoin and convinced that education is the key, I wish to share with you the little knowledge I have and thus contribute to the adoption of Bitcoin. Otherwise, I'm a big fan of Pink Floyd, I'm learning to code, and I make memes. Looking forward to meeting you at the next meet-up! I am the creator of the training course BTC 205 - Non-KYC Purchase Solution.
This tutorial has not been proofread yet
The original content has been translated by AI, but human review is necessary to ensure its accuracy.
3 419 sats1 710 sats855 satsEvery content on the platform is the result of a collaborative effort: each lesson, translation, and revision is made possible by the work of contributors. For this reason, we are always looking for proofreaders who can review our content in many languages. If you want to participate in the proofreading process, please reach out in our Telegram group and read our tutorial. We remind you that this content is open-source - licensed under CC BY-SA - so it can be freely shared and used, as long as the original source is credited.
