Photon Installation

Host and Objective

Target host: Ubuntu ARM64 (aarch64). Objective: build a local Photon development stack for Bitcoin Layer 2 work with bitcoind on regtest, electrs, and rgb-proxy-server.

Environment Preparation

The Docker environment was cleaned with docker compose down --remove-orphans and docker system prune -f before rebuilding the stack.

Compose Stack Created

A new Docker Compose definition was created in /home/waheed/PhotonBoltXYZ/docker-compose.yml.

• bitcoind: configured for regtest with txindex=1, RPC user user, RPC password password.
• electrs: configured for regtest and connected to bitcoind over the internal Docker network.
• rgb-proxy-server: built locally from source instead of using a prebuilt image.

Supporting Configuration Files

• /home/waheed/PhotonBoltXYZ/bitcoin/bitcoin.conf
• /home/waheed/PhotonBoltXYZ/electrs.toml

Source Builds Used

Two pragmatic changes were required during implementation:

• lncm/bitcoind:27.0 was not available as a usable multi-arch manifest from this host, so lncm/bitcoind:v27.2 was used.
• ghcr.io/romanz/electrs:v0.10.4 could not be pulled from GHCR on this host, so electrs v0.10.4 was cloned and built locally from source.

Service Launch

The stack was started with Docker Compose build and up flow. During validation, rgb-proxy-server initially failed because its named volume permissions prevented the container process from creating application directories. The local development workaround applied was to run that container as root inside Compose.

Wallet Funding

After the stack came up:

1. A wallet named photon_dev was created in regtest.
2. A fresh address was generated.
3. 101 blocks were mined to that address.

Final funded wallet balance confirmed with bitcoin-cli getbalance: 50.00000000 BTC.

Security Adjustment After Installation

After Nginx reverse proxying was added, Docker port publishes for Photon services were changed from public host bindings to loopback-only bindings so that the services are exposed through Nginx rather than directly to the public network.

• bitcoind RPC and P2P published on 127.0.0.1
• electrs published on 127.0.0.1
• rgb-proxy published on 127.0.0.1

Result

The Photon Bitcoin/RGB development stack is installed locally and runs on Docker bridge networking with regtest funding in place for development and Lightning-related testing.