starformlabs/stellar-core repository overview

⁠Stellar Core Docker image

⁠Docker Hub

The Docker images are automatically built and published at starformlabs/stellar-core⁠.

⁠Credit

This repo was originally forked from satoshipay/docker-stellar-core⁠. The following are the primary changes.

• Use debian:stretch-slim for the base image
• Install from binaries instead of source
• Add a check to makes sure that postgres is up before starting

⁠Configuration

The container can be fully configured via environment variables.

⁠Environment variables

All Stellar Core config options can be set via environment variables. Here we list the ones you probably want to set:

• NETWORK_PASSPHRASE: default is Public Global Stellar Network ; September 2015 which is the public production network; use Test SDF Network ; September 2015 for the testnet.

• DATABASE: default is sqlite3://stellar.db which you should definitely change for production, e.g., postgresql://dbname=stellar user=postgres host=postgres.

• KNOWN_PEERS: comma-separated list of peers (ip:port) to connect to when below TARGET_PEER_CONNECTIONS, e.g., core-testnet1.stellar.org,core-testnet2.stellar.org,core-testnet3.stellar.org.

• HISTORY: JSON of the following form:

  {
    "h1": { "get": "curl -sf https://s3-eu-west-1.amazonaws.com/history.stellar.org/prd/core-testnet/core_testnet_001/{0} -o {1}" },
    "h2": { "get": "curl -sf https://s3-eu-west-1.amazonaws.com/history.stellar.org/prd/core-testnet/core_testnet_002/{0} -o {1}" },
    "h3": { "get": "curl -sf https://s3-eu-west-1.amazonaws.com/history.stellar.org/prd/core-testnet/core_testnet_003/{0} -o {1}" }
  }
  

  Copy

• QUORUM_SET: JSON of the following form:

  [
    {
      "threshold_percent": 51,
      "validators": ["GDKXE2OZMJIPOSLNA6N6F2BVCI3O777I2OOC4BV7VOYUEHYX7RTRYA7Y  sdf1",
                     "GCUCJTIYXSOXKBSNFGNFWW5MUQ54HKRPGJUTQFJ5RQXZXNOLNXYDHRAP  sdf2",
                     "GC2V2EFSXN6SQTWVYA5EPJPBWWIMSD2XQNKUOHGEKB535AQE2I6IXV2Z  sdf3"]
    },
    {
      "path": "1",
      "threshold_percent": 67,
      "validators": [
        "$self",
        "GDXJAZZJ3H5MJGR6PDQX3JHRREAVYNCVM7FJYGLZJKEHQV2ZXEUO5SX2 some_name"
      ]
    }
  ]
  

  Copy