🌐 Timpi GeoCore Node

Run a GeoCore Node to help power Timpi’s decentralized, location-aware search infrastructure.
Fast. Distributed. Privacy-focused.

---

📌 What is a GeoCore Node?

A GeoCore Node enhances Timpi’s network by routing traffic based on geographic proximity. Each node announces its location, connects to the TAP (Timpi Access Point), and strengthens the decentralized infrastructure.

GeoCore nodes are lightweight and easy to run — perfect for individuals who want to support Timpi with minimal resources.

---

✅ System Requirements

Component	Recommended Minimum
OS	Ubuntu 22.04 LTS (native install)
CPU	4 cores
RAM	8 GB
Storage	3 GB free disk space
Bandwidth	50 Mbps up/down
Uptime	95% minimum (penalties for downtime)
Network	Port forwarding required
Docker	✅ Required
Ports	4100/tcp (default) — open in firewall and router

⚠️ Not officially supported: WSL, Proxmox LXC, Windows/macOS, or limited VMs

---

📝 Step 0 – Register Your GUID

Before running your node, you need to register your unique GeoCore GUID on the Timpi network:

📎 ➡️ GeoCore Registration Page

Once registered, you’ll receive a GUID like:

2f7256b8-c275-429b-8077-01519cced572

---

🛠️ Step 1 – Install Docker

Run these one by one on your Ubuntu 22.04 server:

sudo apt update

sudo apt install -y apt-transport-https ca-certificates curl software-properties-common

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update

sudo apt install -y docker-ce

sudo systemctl status docker

✅ Docker must show active (running) before continuing.

---

🔓 Step 2 – Open Required Ports

If using UFW (firewall):

sudo ufw allow 4100/tcp

If using a home router:

Forward external port 4100 to your server’s internal IP on port 4100 (TCP).

---

🚀 Step 3 – Run in Production Mode (Background)

Once Docker is installed and your GUID is registered, you can run GeoCore in the background with auto-restart enabled:

sudo docker run -d --pull=always --restart unless-stopped \
  --dns=100.42.180.29 --dns=100.42.180.99 --dns=8.8.8.8 \
  -p 4100:4100 \
  -v /var/timpi:/var/timpi \
  -e CONPORT=4100 \
  -e GUID="your-guid-here" \
  -e LOCATION="Sweden/Stockholm" \
  timpiltd/timpi-geocore:latest

Replace:

• your-guid-here with your registered GUID
• Sweden/Stockholm with your real location (e.g., Germany/Berlin, US/Dallas)

---

📖 Step 4 – Monitor Logs

View real-time logs from the latest GeoCore log file:

sudo tail -f $(ls -t /var/timpi/GeoCore-log*.txt | head -n 1)

Output (note: using Custom port 4006):

View real-time logs from the latest GeoCore docker logs (Note: Using Custom Port 4006):

sudo docker logs -f --tail 50 <Container_ID>

💡 Optional shortcut – add this to ~/.bashrc:

echo "alias geocorelog='sudo tail -f \$(ls -t /var/timpi/GeoCore-log*.txt | head -n 1)'" >> ~/.bashrc
source ~/.bashrc

Then use:

geocorelog

---

🧬 Run a Second GeoCore (Optional)

You can run multiple GeoCores on the same machine by:

• Using a different port -p 4101:4101 \ and -e CONPORT=4101 \ (Needs to be the same port number).
• Using a different GUID
• (Optional) Mounting a separate volume

Example:

sudo docker run -d --pull=always --restart unless-stopped \
  -p 4101:4101 \
  -v /var/timpi2:/var/timpi \
  -e CONPORT=4101 \
  -e GUID="your-second-guid" \
  -e LOCATION="Sweden/Stockholm" \
  timpiltd/timpi-geocore:latest

---

🔍 Docker Parameters Reference

Parameter	Description
--pull=always	Always pull the latest image
--restart unless-stopped	Auto-restart container on failure/reboot
--dns	Connect to Timpi DNS
-p 4100:4100	Maps external port to container
-v /var/timpi:/var/timpi	Mounts data folder
-e GUID="..."	Your registered GeoCore GUID
-e CONPORT=4100	Port the GeoCore listens on
-e LOCATION="..."	Location for routing logic

---

Upcoming Feature

Geocore Online Checker Tool to be announced.

🙋 Community & Support

• 💬 Ask in Discord – GeoCore Channel
• 🛠️ Get help in #support
• 🧾 Register your GeoCore: GeoCore Registration Page

---

Built with 🧠 by the Timpi community Empowering a faster, fairer, and decentralized internet 🌍