{"id":14956244,"url":"https://github.com/master-hax/compose-wireguard-ipfs","last_synced_at":"2025-10-01T17:31:09.599Z","repository":{"id":193628422,"uuid":"449999488","full_name":"master-hax/compose-wireguard-ipfs","owner":"master-hax","description":"a multi-container application to run an IPFS node behind a Wireguard client","archived":false,"fork":false,"pushed_at":"2022-03-02T02:26:02.000Z","size":19,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-14T12:00:37.759Z","etag":null,"topics":["compose","docker","docker-compose","ipfs","ipfs-api","ipfs-gateway","ipfs-node","port-forwarding","vpn","wireguard","wireguard-client"],"latest_commit_sha":null,"homepage":"","language":null,"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/master-hax.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}},"created_at":"2022-01-20T07:37:51.000Z","updated_at":"2024-05-30T12:23:47.000Z","dependencies_parsed_at":"2023-09-09T05:27:06.428Z","dependency_job_id":"6402417c-e474-4f70-a10b-4c74c3e80afd","html_url":"https://github.com/master-hax/compose-wireguard-ipfs","commit_stats":null,"previous_names":["master-hax/compose-wireguard-ipfs"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/master-hax%2Fcompose-wireguard-ipfs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/master-hax%2Fcompose-wireguard-ipfs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/master-hax%2Fcompose-wireguard-ipfs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/master-hax%2Fcompose-wireguard-ipfs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/master-hax","download_url":"https://codeload.github.com/master-hax/compose-wireguard-ipfs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234723636,"owners_count":18877085,"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":["compose","docker","docker-compose","ipfs","ipfs-api","ipfs-gateway","ipfs-node","port-forwarding","vpn","wireguard","wireguard-client"],"created_at":"2024-09-24T13:12:35.427Z","updated_at":"2025-10-01T17:31:08.563Z","avatar_url":"https://github.com/master-hax.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# compose-wireguard-ipfs\n\na multi-container Docker application to run an [IPFS node](https://hub.docker.com/r/linuxserver/ipfs) behind a [Wireguard](https://hub.docker.com/r/linuxserver/wireguard) client\n\n## how to set it up\n\n1. download [docker-compose.yml](/docker-compose.yml)\n1. put your `wg0.conf` file into `./wireguard`\n1. run `docker-compose up`\n\nif everything works correctly, go-ipfs should be running behind your VPN!\n\n## how to use it\n\nthe IPFS web UI should be accessible at http://localhost:5001/webui\n\nthe IPFS gateway should be accessible at http://localhost:8080 e.g. http://localhost:8080/ipfs/QmVmtux8UCk8553R2qVa7CBYJbQ11hfyswqEJmTLYCugPx?.png\n\nif you want to use this persistently, you should probably\n1. change the locations of the `ipfs-node-data-volume` \u0026 `downloads-volume`\n1. forward port 4001 with your VPN provider (or pick a different port), then add port forwarding to your `wg0.conf` using the rules proposed [here](https://github.com/linuxserver/docker-wireguard/issues/58#issuecomment-723702782)\n\n## how it works\n\nthe `ipfs-node` service shares the network stack of the `vpn-sidecar` service (Wireguard), which is tunneled through your VPN provider. to maintain local connectivity to the `ipfs-node` container's web UI \u0026 IPFS gateway, we proxy to it to through the `web-proxy` service (Nginx) using [Docker container links](https://docs.docker.com/network/links/).\n\n## note: an [OpenVPN](https://github.com/master-hax/compose-openvpn-ipfs) version is also available\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaster-hax%2Fcompose-wireguard-ipfs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaster-hax%2Fcompose-wireguard-ipfs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaster-hax%2Fcompose-wireguard-ipfs/lists"}