{"id":29224758,"url":"https://github.com/raimo33/full-node","last_synced_at":"2025-07-03T06:07:53.823Z","repository":{"id":302481726,"uuid":"1011978975","full_name":"Raimo33/Full-Node","owner":"Raimo33","description":"lightweight, self hosted, private Bitcoin full node. Knots + Tor + Mempool.","archived":false,"fork":false,"pushed_at":"2025-07-02T15:35:34.000Z","size":6,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-02T16:39:52.984Z","etag":null,"topics":["bitcoin","bitcoin-node","docker","knots"],"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-02T15:35:37.000Z","dependencies_parsed_at":"2025-07-02T16:50:45.084Z","dependency_job_id":null,"html_url":"https://github.com/Raimo33/Full-Node","commit_stats":null,"previous_names":["raimo33/full-node"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Raimo33/Full-Node","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raimo33%2FFull-Node","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raimo33%2FFull-Node/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raimo33%2FFull-Node/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raimo33%2FFull-Node/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Raimo33","download_url":"https://codeload.github.com/Raimo33/Full-Node/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raimo33%2FFull-Node/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263271499,"owners_count":23440396,"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","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","knots"],"created_at":"2025-07-03T06:07:53.537Z","updated_at":"2025-07-03T06:07:53.803Z","avatar_url":"https://github.com/Raimo33.png","language":"Dockerfile","readme":"# Full Node\n\nThis project sets up a minimal Bitcoin full node with the maximum privacy.\n\n- Bitcoin **Full Node**\n- Uses **Knots** for spam prevention\n- Enforces **Tor** for all connections\n- Acts as **Tor Relay** to help the Tor network\n- Uses **Alpine Linux** for a lightweight image\n- Compiled from source for optimized binary\n\nImages size: 81.8MB + 37.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. Create directories for persistent storage:\n   - for Knots to store the blockchain (e.g., `/mnt/hdd/knots`)\n   - for Tor to store its data (e.g., `/var/lib/full-node/tor`)\n\n  WARNING: *if you already have tor installed in your system, or if you're planning to install a tor client to interact with the full node, beware of not mixing the directories. One is for the tor service inside the container, the other is for the tor service running on your host system.*\n\n3. Set ownership of the directories:\n   ```bash\n   chown -R 1000:1000 /mnt/hdd/knots\n   chown -R 1001:1001 /var/lib/full-node/tor\n   ```\n\n4. Update the `.env` file with the correct paths and user/group IDs\n\n5. Edit the `services/knots/bitcoin.conf` file to set your RPC credentials and restrict RPC access to specific IPs.\n\n6. Build the Docker images:\n   ```\n   docker-compose build\n   ```\n\n## Run the services\n\n- Start:\n   ```bash\n   docker-compose up -d\n   ```\n\n- Stop:\n   ```\n  docker-compose down\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## Access the block explorer\n\n#TODO: mempool explorer service","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraimo33%2Ffull-node","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraimo33%2Ffull-node","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraimo33%2Ffull-node/lists"}