{"id":29538681,"url":"https://github.com/raimo33/bitcoin-full-node","last_synced_at":"2025-08-07T18:04:59.697Z","repository":{"id":302481726,"uuid":"1011978975","full_name":"Raimo33/Bitcoin-Full-Node","owner":"Raimo33","description":"lightweight, private Bitcoin full node","archived":false,"fork":false,"pushed_at":"2025-07-13T12:55:26.000Z","size":730,"stargazers_count":0,"open_issues_count":10,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-07-13T14:37:10.684Z","etag":null,"topics":["bitcoin","bitcoin-node","docker","i2p","knots","tor"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Raimo33.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-01T16:08:29.000Z","updated_at":"2025-07-13T13:09:11.000Z","dependencies_parsed_at":"2025-07-06T01:30:46.813Z","dependency_job_id":"e8beca2c-9b05-4ed3-b434-d8fc73bd257d","html_url":"https://github.com/Raimo33/Bitcoin-Full-Node","commit_stats":null,"previous_names":["raimo33/full-node","raimo33/bitcoin-full-node"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Raimo33/Bitcoin-Full-Node","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raimo33%2FBitcoin-Full-Node","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raimo33%2FBitcoin-Full-Node/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raimo33%2FBitcoin-Full-Node/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raimo33%2FBitcoin-Full-Node/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Raimo33","download_url":"https://codeload.github.com/Raimo33/Bitcoin-Full-Node/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raimo33%2FBitcoin-Full-Node/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269300876,"owners_count":24394063,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-07T02:00:09.698Z","response_time":73,"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":["bitcoin","bitcoin-node","docker","i2p","knots","tor"],"created_at":"2025-07-17T05:08:58.159Z","updated_at":"2025-08-07T18:04:59.681Z","avatar_url":"https://github.com/Raimo33.png","language":"Dockerfile","readme":"# Bitcoin Full Node\n\nThis project sets up a minimal Bitcoin full node with the maximum privacy.\n\n- **Full** blockchain state\n- Uses **Knots** to fight the spam\n- Enforces **Tor** or **i2p** for all connections\n- Acts as **Tor Relay** to help the Tor network\n- Acts as a **i2p Router** to help the i2p network\n- Uses **Alpine Linux** for lightweight images\n- **Compiled** from source for optimized binary\n- GPG **Signature verification** for all components\n\nImages size:\n- Knots: 35.4MB\n- Tor client: 20.2MB\n- Tor relay: 20.4MB\n- i2p: 22.7MB\n\n## First time setup instructions\n\n1. Install Docker and Docker Compose on your system:\n    - [Docker installation guide](https://docs.docker.com/engine/install/)\n    - [Docker Compose installation guide](https://docs.docker.com/compose/install/standalone)\n\n2. Edit the `.env` file:\n```bash\n# directories where persistent data will be stored\nKNOTS_DATA=/mnt/hdd/bitcoin/knots\nTOR_DATA=/var/lib/bitcoin/tor\nI2P_DATA=/var/lib/bitcoin/i2pd\n\n# user ID that owns the data directories, will be used to run the containers\nUID=1000\n\n# your host machine public IP address, used by Tor and i2p to advertise the service\nHOST_PUBLIC_IP=87.19.107.144\n\n# RPC credentials for Knots\nRPC_USER=your_rpc_user\nRPC_PASSWORD=your_rpc_password\n\n# Tor control credentials used internally\nTOR_CONTROL_PASSWORD=your_tor_control_password\nTOR_CONTROL_HASHED_PASSWORD=16:ADDBD7CF108C995F60F831F115BA5EB95322FC4645433CDEB8948A57DF\n```\n\nWARNING: *if you already have tor installed on your system, make sure that your TOR_DATA directory is not the same as the one already used by your system tor installation. One is used inside the containers, the other is used by your system tor service.*\n\nWARNING: *if you plan to run the node for multiple sessions, make sure that the HOST_PUBLIC_IP is up to date with the current public IP of your host machine. It is strongly recommended to use a static IP*\n\n3. Build the Docker images:\n   ```bash\n   docker-compose build\n   ```\n\n## Run the services\n\n```bash\ndocker-compose up -d   # Start\ndocker-compose down    # Stop\n```\n\nNOTE: *Docker automatically stops and restarts containers on system reboot.*\n\nmore information about the available docker-compose commands can be found in the [docker-compose documentation](https://docs.docker.com/reference/cli/docker/compose/).\n\n## Accessing the node\n\nThe node is now listening for RPC connections on port `8332` of the host machine. You can interact with it using the `bitcoin-cli` command, software wallets, mempool explorers, or any other Core/Knots RPC compatible client.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraimo33%2Fbitcoin-full-node","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraimo33%2Fbitcoin-full-node","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraimo33%2Fbitcoin-full-node/lists"}