Official Phoenixd Guide
last updated: September 8, 2025
Requirements:
- phoenixd
- reachable from the internet via clearnet and HTTPS
- some experience with networking: HTTPS, reverse proxy, CORS
Setup phoenixd
- Download latest phoenixd release from Github here
- Unzip and run the
phoenixdbinary
By default, it binds to 127.0.0.1 on port 9740. To make it reachable from the internet, you need to pass
--http-bind.ip=0.0.0.0 or run a reverse proxy.You also need to enable Cross-Origin Resource Sharing (CORS) for sending.
Here is an example nginx site config with CORS and HTTPS:
upstream phoenixd {
server 127.0.0.1:9740;
}
server {
server_name phoenixd.ekzy.is;
listen 80;
listen [::]:80;
return 301 https://phoenixd.ekzy.is$request_uri;
}
server {
server_name phoenixd.ekzy.is;
listen 443 ssl;
listen [::]:443 ssl;
ssl_certificate /etc/letsencrypt/live/phoenixd.ekzy.is/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/phoenixd.ekzy.is/privkey.pem;
location / {
if ($request_method = OPTIONS) {
return 204;
}
add_header 'Access-Control-Allow-Origin' '*' always;
add_header 'Access-Control-Allow-Headers' '*' always;
add_header 'Access-Control-Allow-Methods' 'GET,POST,OPTIONS,PUT,DELETE,PATCH' always;
proxy_set_header Host $http_host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Prefix /;
proxy_pass http://phoenixd$request_uri;
}
}
Attach send
Enter the URL to your phoenixd instance and what can be found as
http-password in your phoenixd config (default location: ~/.phoenix/phoenix.conf).Attach receive
Enter the URL to your phoenixd instance and what can be found as
http-password-limited-access in your phoenixd config (default location: ~/.phoenix/phoenix.conf).