https://github.com/zer-far/onion-nest
Host onion services through a VPN connection using Docker.
https://github.com/zer-far/onion-nest
caddy darknet docker gluetun hidden-services onion onion-service onion-services tor tor-hidden-services vpn
Last synced: about 2 months ago
JSON representation
Host onion services through a VPN connection using Docker.
- Host: GitHub
- URL: https://github.com/zer-far/onion-nest
- Owner: zer-far
- License: mit
- Created: 2024-10-29T12:40:16.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-01-24T19:35:12.000Z (9 months ago)
- Last Synced: 2025-07-09T16:07:38.796Z (3 months ago)
- Topics: caddy, darknet, docker, gluetun, hidden-services, onion, onion-service, onion-services, tor, tor-hidden-services, vpn
- Language: HTML
- Homepage:
- Size: 17.6 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# onion-nest
Host onion services through a VPN connection using Docker.
## Overview
Docker is used to run:
- Tor: To manage onion services.
- Caddy: To serve content.
- Gluetun: To route Tor traffic through a VPN connection.
## Set up
### Prerequisites
- Docker
- Git
### Instructions
1. **Clone the repository.**
```bash
git clone https://github.com/zer-far/onion-nest
cd onion-nest
```
2. **Modify environment variables.**
- Set up a VPN connection by configuring the template for your provider in the [Gluetun Wiki](https://github.com/qdm12/gluetun-wiki/tree/main/setup/providers).
3. **Build and run the containers.**
```bash
docker compose -f compose.yml up -d --build
```
4. **Get your onion service address.**
Wait for Tor to connect, then run:
```bash
cat onion/hidden_service/hostname
```
5. **Access your onion service.**
## Notes
- You can use [mkp224o](https://github.com/cathugger/mkp224o) to generate a vanity address.