https://github.com/keithhetrick/hidden-coffee
A minimalist Tor hidden service that serves a static 'Hidden Coffee' page over the dark web using Docker and Nginx — for educational purposes only.
https://github.com/keithhetrick/hidden-coffee
docker nginx onion tor
Last synced: about 1 month ago
JSON representation
A minimalist Tor hidden service that serves a static 'Hidden Coffee' page over the dark web using Docker and Nginx — for educational purposes only.
- Host: GitHub
- URL: https://github.com/keithhetrick/hidden-coffee
- Owner: keithhetrick
- Created: 2025-06-02T05:16:57.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-06T20:18:15.000Z (about 1 year ago)
- Last Synced: 2025-07-14T14:50:03.501Z (12 months ago)
- Topics: docker, nginx, onion, tor
- Language: HTML
- Homepage:
- Size: 7.81 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🧅 Hidden Coffee ☕
A minimalist, educational Tor Hidden Service built using Docker. It serves a static "Hidden Coffee" HTML site accessible only via the Tor network. Great for learning how `.onion` services work, without publishing sensitive data.
---
## 📸 Preview
---
## 🔧 Features
- Fully static HTML site served via Nginx
- Runs as a hidden service over Tor in Docker
- No need for a domain or HTTPS — uses a `.onion` address
- Completely self-contained, no tracking or analytics
- No `.env` file required
---
## 🛠️ Requirements
- [Docker](https://www.docker.com/)
- [Tor Browser](https://www.torproject.org/)
---
## 🚀 Getting Started
### 1. Clone this repo
```bash
git clone https://github.com/keithhetrick/hidden-coffee.git
cd hidden-coffee
```
### 2. Build Docker Image
From the root of the project directory, run:
```bash
docker build -t hidden-coffee .
```
### 3. Run Docker Container
```bash
docker run -d --name hidden-coffee hidden-coffee
```
This will:
- Build the image
- Start a container running Nginx + Tor
- Create a hidden service on your machine
---
## 🌐 Get Your `.onion` Address
### 4. Once the container is running, open another terminal and run:
```bash
docker exec hidden-coffee cat /var/lib/tor/hidden_service/hostname
```
You’ll see an address like:
```text
zgcypcvt3apooici2bixzq7zatg5nyqny2omg4drdcdui4il5y6dqvad.onion
```
> 📌 **Note**: This is an example .onion address for demo purposes only. Run the container to generate your own address.
---
### 5. Open the `.onion` address in [Tor Browser](https://www.torproject.org/)
Paste the `.onion` address into the Tor Browser address bar — and voilà: Hidden Coffee is served. ☕
---
## 💡 Notes
- No sensitive info (like `.env` files or private keys) is committed.
- This setup uses a **non-persistent** `.onion` address by default.
- The container runs in the background and serves the site only over Tor.
- Tor sites are slower than clearnet — keep it simple.
---
## 🛑 Stop the Service
```bash
docker stop hidden-coffee
```
This will stop and remove the container. If you’re not using persistence, the `.onion` address will change the next time you run it.
---
## 🧪 Future Ideas
- Brew counter using localStorage or file-based backend
- Persistent `.onion` address using Docker volumes
- Hosting on a Raspberry Pi or similar device
- Add themed styles or multiple pages
- Docker Hub deploy / GitHub Actions
---
## 🧠 Educational Purpose Only
This project is for **educational and lawful** use only. It demonstrates how Tor hidden services work in a safe, offline, self-hosted context.
---
## ☕ Inspired By
- Tor Project
- Static web hacking
- Late-night coffee sessions
---
## 📄 License
This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.