{"id":39511533,"url":"https://github.com/block-foundation/docker-polkadot-node","last_synced_at":"2026-01-18T06:03:48.154Z","repository":{"id":183298632,"uuid":"669490252","full_name":"block-foundation/docker-polkadot-node","owner":"block-foundation","description":"Polkadot Node Docker Image","archived":false,"fork":false,"pushed_at":"2025-01-13T08:48:03.000Z","size":684,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-04T22:24:30.878Z","etag":null,"topics":["blockchain","blockfoundation","docker","dot","node","polkadot"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/orgs/blockfoundation","language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-sa-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/block-foundation.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":".github/SUPPORT.md","governance":".github/GOVERNANCE.md","roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"block-foundation","open_collective":"block"}},"created_at":"2023-07-22T12:56:11.000Z","updated_at":"2024-08-11T11:12:02.000Z","dependencies_parsed_at":"2025-04-12T01:48:54.742Z","dependency_job_id":"f1f6089d-fb29-4a71-9656-53812944dc17","html_url":"https://github.com/block-foundation/docker-polkadot-node","commit_stats":null,"previous_names":["block-foundation/docker-polkadot-node"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/block-foundation/docker-polkadot-node","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block-foundation%2Fdocker-polkadot-node","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block-foundation%2Fdocker-polkadot-node/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block-foundation%2Fdocker-polkadot-node/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block-foundation%2Fdocker-polkadot-node/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/block-foundation","download_url":"https://codeload.github.com/block-foundation/docker-polkadot-node/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block-foundation%2Fdocker-polkadot-node/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28531992,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","blockfoundation","docker","dot","node","polkadot"],"created_at":"2026-01-18T06:03:47.356Z","updated_at":"2026-01-18T06:03:48.145Z","avatar_url":"https://github.com/block-foundation.png","language":"HCL","funding_links":["https://github.com/sponsors/block-foundation","https://opencollective.com/block"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"right\"\u003e\n\n[![GitHub License](https://img.shields.io/github/license/block-foundation/blocktxt?style=flat-square\u0026logo=readthedocs\u0026logoColor=FFFFFF\u0026label=\u0026labelColor=%23041B26\u0026color=%23041B26\u0026link=LICENSE)](https://github.com/block-foundation/brand/blob/main/LICENSE)\n[![devContainer](https://img.shields.io/badge/Container-Remote?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=%23FFFFFF\u0026label=Remote\u0026labelColor=%23041B26\u0026color=%23041B26)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/block-foundation/brand)\n[![Docker Pulls](https://img.shields.io/docker/pulls/blockfoundation/polkadot-node?style=flat-square\u0026logo=docker\u0026logoColor=%23FFFFFF\u0026label=Pulls:\u0026labelColor=%23041B26\u0026color=%23041B26)](https://hub.docker.com/r/blockfoundation/polkadot-node)\n[![Docker Stars](https://img.shields.io/docker/stars/blockfoundation/polkadot-node?style=flat-square\u0026logo=docker\u0026logoColor=%23FFFFFF\u0026label=Stars:\u0026labelColor=%23041B26\u0026color=%23041B26)](https://hub.docker.com/r/blockfoundation/polkadot-node)\n[![Docker Image Version (latest semver)](https://img.shields.io/docker/v/blockfoundation/polkadot-node?sort=semver\u0026style=flat-square\u0026logo=docker\u0026logoColor=%23FFFFFF\u0026label=Version:\u0026labelColor=%23041B26\u0026color=%23041B26)](https://hub.docker.com/r/blockfoundation/polkadot-node/tags)\n[![Docker Size](https://img.shields.io/docker/image-size/blockfoundation/polkadot-node/latest?style=flat-square\u0026logo=docker\u0026logoColor=%23FFFFFF\u0026label=Size:\u0026labelColor=%23041B26\u0026color=%23041B26)](https://hub.docker.com/r/blockfoundation/polkadot-node)\n\n\u003c/div\u003e\n\n---\n\n\u003cdiv\u003e\n    \u003cimg align=\"right\" src=\"https://raw.githubusercontent.com/block-foundation/brand/master/src/logo/logo_gray.png\" width=\"96\" alt=\"Block Foundation Logo\"\u003e\n    \u003ch1 align=\"left\"\u003ePolkadot Node\u003c/h1\u003e\n    \u003ch3 align=\"left\"\u003eBlock Foundation Docker Containers\u003c/h3\u003e\n\u003c/div\u003e\n\n---\n\n\u003cimg align=\"right\" width=\"75%\" src=\"https://raw.githubusercontent.com/block-foundation/brand/master/src/image/repository_cover/block_foundation-containers.jpg\"  alt=\"Block Foundation Containers\"\u003e\n\n### Contents\n\n- [Introduction](#introduction)\n- [Colophon](#colophon)\n\n\u003cbr clear=\"both\"/\u003e\n\n---\n\n\u003cdiv align=\"right\"\u003e\n\n[![Report a Bug](https://img.shields.io/badge/Report%20a%20Bug-GitHub?style=flat-square\u0026\u0026logoColor=%23FFFFFF\u0026color=%23E1E4E5)](https://github.com/block-foundation/docker-polkadot-node/issues/new?assignees=\u0026labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected\u0026projects=\u0026template=bug_report.yml)\n[![Request a Feature](https://img.shields.io/badge/Request%20a%20Feature-GitHub?style=flat-square\u0026\u0026logoColor=%23FFFFFF\u0026color=%23E1E4E5)](https://github.com/block-foundation/docker-polkadot-node/issues/new?assignees=\u0026labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected\u0026projects=\u0026template=feature_request.yml)\n[![Ask a Question](https://img.shields.io/badge/Ask%20a%20Question-GitHub?style=flat-square\u0026\u0026logoColor=%23FFFFFF\u0026color=%23E1E4E5)](https://github.com/block-foundation/docker-polkadot-node/issues/new?assignees=\u0026labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected\u0026projects=\u0026template=question.yml)\n[![Make a Suggestion](https://img.shields.io/badge/Make%20a%20Suggestion-GitHub?style=flat-square\u0026\u0026logoColor=%23FFFFFF\u0026color=%23E1E4E5)](https://github.com/block-foundation/docker-polkadot-node/issues/new?assignees=\u0026labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected\u0026projects=\u0026template=suggestion.yml)\n[![Start a Discussion](https://img.shields.io/badge/Start%20a%20Discussion-GitHub?style=flat-square\u0026\u0026logoColor=%23FFFFFF\u0026color=%23E1E4E5)](https://github.com/block-foundation/docker-polkadot-node/issues/new?assignees=\u0026labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected\u0026projects=\u0026template=discussion.yml)\n\n\u003c/div\u003e\n\n## Introduction\n\nWelcome to the Block Foundation's Polkadot Node Docker Image Repository! This repository embodies our dedication to open-source development and our commitment to making blockchain technology accessible and straightforward for everyone.\n\nPolkadot, for those unfamiliar, is a sharded, scalable, interoperable, and secure network protocol for the next web generation. It provides an environment for connecting multiple chains together in a single network, enabling them to process transactions in parallel and exchange data efficiently. Docker, on the other hand, is a leading platform used for automating the deployment, scaling, and management of applications within containers.\n\nThis repository houses a Docker image that has been specifically designed for the effortless operation of a Polkadot Node. By leveraging the advantages of Docker, this image simplifies the process of setting up and running a Polkadot Node, thereby making the power of the Polkadot network accessible to a broader audience.\n\nWithin this repository, you'll find the Dockerfile used to build the image and step-by-step instructions on how to deploy and run the Docker image. We wholeheartedly encourage everyone to use this image, contribute towards its development, and share their insights to help improve it.\n\nBy providing this tool, we hope to reduce barriers to participation in the world of blockchain technology and align it with our broader mission of revolutionizing the architectural and real estate sectors. Every contribution, no matter its size, brings us closer to our shared goal of a more inclusive, sustainable, and technologically advanced future.\n\nWe are thrilled to have you here and look forward to your valuable contributions to the Block Foundation community. Thank you for being a part of this exciting journey towards a more decentralized future!\n\n## Setup\n\n### Environment Variables\n\nYou can pass a number environment variables to configure the node\n\n#### Flags\n\n| Environment Variable            | Flag                    | Description |\n| ------------------------------- | ----------------------- | ----------- |\n| `POLKADOT_ENABLE_DEV`           | `--dev`                 | Run in development mode; implies `--chain=dev --validator --key Alice` |\n| `POLKADOT_ENABLE_LIGHTCLIENT`   | `--light`               | Run in light client mode |\n| `POLKADOT_NO_TELEMETRY`         | `--no-telelmetry`       | Should not connect to the Polkadot telemetry server (telemetry is on by default on global chains) |\n| `POLKADOT_TELEMETRY`            | `-t` `--telemetry`      | Listen to all RPC interfaces (default is local) |\n| `POLKADOT_VALIDATOR`            | `--validator`           | Enablevalidator mode |\n| `POLKADOT_RPC_EXTERNAL`         | `--rcp-external`        | Listen to all RPC interfaces (default is local) |\n| `POLKADOT_WS_EXTERNAL`          | `--ws-external`         | Listen to all Websocket interfaces (default is local) |\n\n#### Options\n\n| Environment Variable            | Flag                    | Description |\n| ------------------------------- | ----------------------- | ----------- |\n| `POLKADOT_BASE_PATH`            | `-d` `--base-path`      | Specify custom base path |\n| `POLKADOT_BOOTNODES`            | `--bootnodes`           | Specify a list of bootnodes |\n| `POLKADOT_CHAIN`                | `--chain`               | Specify the chain specification (one of krummelanke, dev, local or staging) |\n| `POLKADOT_DB_CACHE`             | `--db-cache`            | Limit the memory the database cache can use |\n| `POLKADOT_EXECUTION`            | `--execution`           | The means of execution used when calling into the runtime. Can be either wasm, native or both. |\n| `POLKADOT_IN_PEERS`             | `--in-peers`            | Specify the maximum number of incoming connections we're accepting |\n| `POLKADOT_KEY`                  | `--key`                 | Specify additional key seed |\n| `POLKADOT_KEYSTORE_PATH`        | `--keystore-path`       | Specify custom keystore path |\n| `POLKADOT_LISTEN_ADDR`          | `--listen-addr`         | Listen on this multiaddress |\n| `POLKADOT_LOG`                  | `-l` `--log`            | Sets a custom logging filter |\n| `POLKADOT_MAX_HEAP_PAGES`       | `--max-heap-pages`      | The maximum number of 64KB pages to ever allocate for Wasm execution. Don't |\n| `POLKADOT_MIN_HEAP_PAGES`       | `--min-heap-pages`      | The number of 64KB pages to allocate for Wasm execution initially. |\n| `POLKADOT_NAME`                 | `--name`                | The human-readable name for this node, as reported to the telemetry server, if enabled |\n| `POLKADOT_NODE_KEY`             | `--node-key`            | Specify node secret key (64-character hex string) |\n| `POLKADOT_PORT`                 | `--port`                | Specify p2p protocol TCP port |\n| `POLKADOT_PRUNING`              | `--pruning`             | Specify the pruning mode, a number of blocks to keep or \"archive\". Default is 256. |\n| `POLKADOT_RESERVED_NODES`       | `--reserved-nodes`      | Specify a list of reserved node addresses |\n| `POLKADOT_RPC_PORT`             | `--rpc-port`            | Specify HTTP RPC server TCP port |\n| `POLKADOT_WS_PORT`              | `--ws-port`             | Specify WebSockets RPC server TCP port |\n| `POLKADOT_TELEMETRY_URL`        | `--telemetry-url`       | The URL of the telemetry server. Implies `--telemetry` |\n\n## Resources\n\n- https://hub.docker.com/r/parity/polkadot/\n- https://hub.docker.com/r/ajcrowe/polkadot\n- https://github.com/paritytech/polkadot/blob/master/doc/docker.md\n- https://wiki.polkadot.network/docs/maintain-sync\n- https://albertocevallos.medium.com/setting-up-a-polkadot-node-the-easy-way-3a885283091f\n\n---\n\n## Colophon\n\n### Authors\n\nThis is an open-source project by the **[Block Foundation](https://www.blockfoundation.io \"Block Foundation website\")**.\n\nThe Block Foundation mission is enabling architects to take back initiative and contribute in solving the mismatch in housing through blockchain technology. Therefore the Block Foundation seeks to unschackle the traditional constraints and construct middle ground between rent and the rigidity of traditional mortgages.\n\nwebsite: [www.blockfoundation.io](https://www.blockfoundation.io \"Block Foundation website\")\n\n### Development Resources\n\n#### Contributing\n\nWe'd love for you to contribute and to make this project even better than it is today!\nPlease refer to the [contribution guidelines](.github/CONTRIBUTING.md) for information.\n\n### Legal Information\n\n#### Copyright\n\nCopyright \u0026copy; 2023 [Stichting Block Foundation](https://www.blockfoundation.io/ \"Block Foundation website\"). All Rights Reserved.\n\n#### License\n\nExcept as otherwise noted, the content in this repository is licensed under the\n[Creative Commons Attribution 4.0 International (CC BY 4.0) License](https://creativecommons.org/licenses/by/4.0/), and\ncode samples are licensed under the [Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\n\nAlso see [LICENSE](https://github.com/block-foundation/community/blob/master/src/LICENSE) and [LICENSE-CODE](https://github.com/block-foundation/community/blob/master/src/LICENSE-CODE).\n\n#### Disclaimer\n\n**THIS SOFTWARE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblock-foundation%2Fdocker-polkadot-node","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblock-foundation%2Fdocker-polkadot-node","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblock-foundation%2Fdocker-polkadot-node/lists"}