How do I deploy my own Cordite node?¶
We use Docker to deploy Cordite nodes. For instructions on starting up a Cordite node using Docker, please visit our Docker Hub Repo for more information on configuration including environment variables:
$ docker run -p 8080:8080 -p 10002:10002 cordite/cordite
Once the node is running, you will be able to see the REST API for accessing Cordite at https://localhost:8080/api
If you do not wish to use Docker then alternatively you can download the
latest Cordite
node
and run without docker by running ./start.sh
. You will need Oracle
JRE 8 JVM - minimum supported version 8u131.
Environment Variables¶
Cordite uses environment variables to configure Cordite and create amoungst other things the Corda node.conf file.
Env Name | Description | Default |
---|---|---|
CORDITE_LEGAL _NAME | The name of the node | O=Cordite-XXX, OU=Cordite, L=London, C=GB |
CORDITE_P2P_ ADDRESS | The address other nodes will use to speak to your node | localhost:10002 |
CORDITE_COMPA TIBILITY_ZONE _URL | The address of the Network Map Service. | https://network -map-test.cordi te.foundation |
CORDITE_KEY_ STORE_PASSWOR D | Keystore password | cordacadevpass |
CORDITE_TRUST _STORE_PASSW ORD | Truststore password | trustpass |
CORDITE_DB_U SER | Username for db | sa |
CORDITE_DB_P ASS | Password for db | dnpass |
CORDITE_DB_D IR | Path to db directory | /opt/cordite/db / |
CORDITE_BRAID _PORT | Braid port | 8080 |
CORDITE_DEV_ MODE | Start up node in dev mode | true |
CORDITE_DETEC T_IP | Allow node to auto detect external visible IP | false |
CORDITE_TLS_ CERT_PATH | Path to TLS certificate | null |
CORDITE_TLS_ KEY_PATH | Path to TLS Key | null |
CORDITE_NOTAR Y | Set to true to be a validating notary, false for non-validating or do not set to be a notary | null |
CORDITE_METER ING_CONFIG | JSON to set metering notary configuration | null |
CORDITE_FEE_ DISPERSAL_CON FIG | JSON to set metering fee dispersal config | null |
Volume Mounts¶
File/Folder | Description |
---|---|
/opt/cordite/n ode.conf | Configuration file detailing specifics of your node - will be created using env variables if a node.conf is not mounted |
/opt/cordite/d b | Location of the database for that node - for persistence, use volume mount |
/opt/cordite/c ertificates | Location of the nodes’ corda certificates - will be created if no certificates are mounted to node and devmode=true |
/opt/cordite/t ls-certificate s | Location of TLS certificates - will use self-signed certificates if none are mounted to node |