How to Use
Fresh Installation
Check the Docker README documentation for Docker setup snippets and tips.
New containers are up and running from the start — no extra configuration needed.
Upgrading from Previous Version
Update the image in your docker compose file:
image: pinetwork/pi-node-docker:organization-mainnet-v1.0-p21.2See this for an example of a docker-compose.yml.
Note: Auto-migrations are now enabled by default — migrations will run automatically. To opt out, pass --disable-auto-migrations.
Expected downtime
This release includes data migrations (003_fix_validator3_port, 004_deprecated_sql_ledger_state) that run automatically on container startup. Expect a brief service interruption during container restart while the migrations complete and the new binary initializes. No reingestion required. Usually completes in under 5 minutes; in rare cases, restarts may take longer—please allow them to finish.
Docker container available at: pinetwork/pi-node-docker:organization-mainnet-v1.0-p21.2
Release Notes
Version Updates
| Component | Previous | New |
|---|---|---|
| stellar-core | 20.2.0-1720.34d82fc00.focal | v21.2.0 |
| horizon | 2.30.0-436 | v2.32.0 |
Changes
Build
- Switched stellar-core and horizon from apt packages to source-built binaries using multi-stage Docker build
- Added
Dockerfile.coreandDockerfile.horizonto build from source - Added libc++ runtime libs (
libc++1-12,libc++abi1-12,libunwind8) required by stellar-core built with clang - Removed stellar apt package installs from
installscript; binaries now copied from build stages
Configuration
- Added
DEPRECATED_SQL_LEDGER_STATE=falseto defaultstellar-core.cfg(required by stellar-core 21.x)
Runtime
- Auto-migrations are now enabled by default (
ENABLE_AUTO_MIGRATIONS=true) - Added
--disable-auto-migrationsruntime flag to opt out - Kept
--enable-auto-migrationsflag for backward compatibility
Migrations
- Added migration
003_fix_validator3_port: fixes wrong port forvalidator3instellar-core.cfgandstellar-core-captive.yml(31502→31402) - Added migration
004_deprecated_sql_ledger_state: setsDEPRECATED_SQL_LEDGER_STATE=falseinstellar-core.cfgfor nodes upgrading from 20.x