{"id":29520989,"url":"https://github.com/allisson/raspnode","last_synced_at":"2026-05-08T04:13:40.146Z","repository":{"id":304725548,"uuid":"1017041941","full_name":"allisson/raspnode","owner":"allisson","description":"Simple HomeLab setup for Raspberry Pi (4 or 5).","archived":false,"fork":false,"pushed_at":"2025-07-14T22:52:05.000Z","size":18,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-15T00:45:26.717Z","etag":null,"topics":["homelab","homelab-setup","raspberry-pi","tailscale"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/allisson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-10T00:00:46.000Z","updated_at":"2025-07-14T22:52:08.000Z","dependencies_parsed_at":"2025-07-15T00:45:30.025Z","dependency_job_id":"87fc3580-2cf2-4094-8d79-419b6e263bbb","html_url":"https://github.com/allisson/raspnode","commit_stats":null,"previous_names":["allisson/raspnode"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/allisson/raspnode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allisson%2Fraspnode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allisson%2Fraspnode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allisson%2Fraspnode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allisson%2Fraspnode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/allisson","download_url":"https://codeload.github.com/allisson/raspnode/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allisson%2Fraspnode/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265522959,"owners_count":23781746,"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":["homelab","homelab-setup","raspberry-pi","tailscale"],"created_at":"2025-07-16T16:02:01.939Z","updated_at":"2026-05-08T04:13:40.140Z","avatar_url":"https://github.com/allisson.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Raspnode\n\nThe configuration I use on my Raspberry Pi 4 (8GB), which is my HomeLab.\n\n# About\n\nI don't plan to significantly change this project. The goal is to keep it simple as a starting point, so people can set up their HomeLab using a Raspberry Pi (model 4 or 5) with basic services and secure access through Tailscale.\n\nTherefore, I will keep this repository read-only. Please do not open issues or submit pull requests, but feel free to fork or clone it. It is licensed under the MIT license.\n\n# Requirements\n\n- Raspberry Pi OS Lite 64-bit.\n- Docker https://docs.docker.com/engine/install/debian/ (don't forget to add the user to the docker group https://docs.docker.com/engine/install/linux-postinstall/).\n- Tailscale authkey with the reuse option enabled https://login.tailscale.com/admin/settings/keys.\n- Tailscale with the \"HTTPS Certificates\" enabled https://login.tailscale.com/admin/dns.\n\n# Services\n\n- Vaultwarden: https://github.com/dani-garcia/vaultwarden.\n- Portainer: https://github.com/portainer/portainer.\n- Beszel: https://github.com/henrygd/beszel.\n- Blocky: https://github.com/0xERR0R/blocky.\n- Bitcoin Core: https://github.com/willcl-ark/bitcoin-core-docker.\n- N8N: https://github.com/n8n-io/n8n.\n- Duplicati: https://github.com/duplicati/duplicati.\n\n# How to use\n\n## Create the app-data directory\n\n```bash\nmake create-app-data\n```\n\n## Copy the env.sample to .env and edit the values\n\n```bash\ncp env.sample .env\n# vim .env or nano .env\n```\n\nThe BESZEL_AGENT_KEY variable must be changed after the Beszel service is started. \n\nThis is necessary because we need to get the public key that is generated at the first start.\n\n## Start the containers\n\n```bash\ndocker compose up -d\n```\n\n## Open the Beszel service to get the value for the BESZEL_AGENT_KEY variable\n\nIf you have not changed the value of the BESZEL_HOSTNAME variable, the address should be https://beszel.your-tailnet-name.ts.net.\n\nCreate the administrator account, and after logging in, click on \"Add New System\" and copy the value of the \"Public Key\" field in the BESZEL_AGENT_KEY variable in the .env file.\n\nNow, stop and restart the services to load the new values from the .env file.\n\n```bash\ndocker compose stop\ndocker compose up -d\n```\n\nNow go back to the Beszel website and click \"Add New System\" again, filling in the \"Name\" as \"raspnode\" and the \"Host / IP\" as \"/beszel_socket/beszel.sock\".\n\n## Fix Beszel memory stats in Docker\n\nFollow these instructions https://akashrajpurohit.com/blog/resolving-missing-memory-stats-in-docker-stats-on-raspberry-pi/.\n\n## Change the default password of bitcoin core rpc\n\nThe default user and password to access the Bitcoin Core RPC are \"bitcoin.\" \n\nIf you want to change these credentials, generate a new credential and change the value of rpcauth in the file ./app-config/bitcoin-knots/bitcoin.conf.\n\n```bash\npython ./app-config/bitcoin-core/rpcaut.py username password\nString to be appended to bitcoin.conf:\nrpcauth=username:e87b62cd0e9c2066238f876f4e2c6a6a$72a7c7ef9aa3d39aada4b7a8f8f00f4775c5147deec27d62ff17d88ac2b8c043\nYour password:\npassword\n```\n\nNow, stop and restart the services to load the new values from the .env file.\n\n```bash\ndocker compose stop\ndocker compose up -d\n```\n\n## Enjoy your HomeLab\n\n- Vaultwarden: https://vaultwarden.your-tailnet-name.ts.net\n- Portainer: https://portainer.your-tailnet-name.ts.net\n- Beszel: https://beszel.your-tailnet-name.ts.net.\n- Blocky: The port 53 UDP/TCP is open to serve DNS requests on your local network, the config is located on ./app-config/blocky/config.yml.\n- Bitcoin Core: The ports 8332/8333/28332/28333 are open on bitcoin.your-tailnet-name.ts.net.\n- N8N: https://n8n.your-tailnet-name.ts.net.\n- Duplicati: https://duplicati.your-tailnet-name.ts.net.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallisson%2Fraspnode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fallisson%2Fraspnode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallisson%2Fraspnode/lists"}