https://github.com/techulus/cloud
Techulus Cloud Platform
https://github.com/techulus/cloud
Last synced: 3 days ago
JSON representation
Techulus Cloud Platform
- Host: GitHub
- URL: https://github.com/techulus/cloud
- Owner: techulus
- License: agpl-3.0
- Created: 2025-03-10T05:24:44.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-06-22T13:19:08.000Z (9 days ago)
- Last Synced: 2026-06-22T15:17:45.938Z (8 days ago)
- Language: TypeScript
- Homepage: https://techulus.cloud
- Size: 3.52 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Agents: docs/AGENTS.md
Awesome Lists containing this project
README
# Techulus Cloud
A container deployment platform with private-first networking.
> **Beta**: This project is currently in beta and pre-production. Use at your own risk.
## Features
- **Container Orchestration**: Deploy containers via Podman with static IPs and automatic rollouts
- **WireGuard Mesh**: Full mesh private networking between all servers
- **Two Node Types**: Proxy nodes handle public traffic, worker nodes run containers
- **Automatic HTTPS**: Centralized ACME certificate management with Let's Encrypt
- **Service Discovery**: Built-in DNS server for `.internal` domain resolution
- **Geographic Distribution**: Multi-proxy support capable of proximity-aware load balancing
## Tech Stack
| Component | Technology |
|-----------|------------|
| Control Plane | Next.js (full-stack) |
| Database | PostgreSQL + Drizzle |
| Server Agent | Go |
| Container Runtime | Podman |
| Reverse Proxy | Traefik |
| Private Network | WireGuard |
## How It Works
```mermaid
flowchart LR
subgraph Control Plane
CP[Next.js + PostgreSQL]
end
subgraph Servers
direction TB
P[Proxy Node
Traefik + Agent + Containers]
W1[Worker Node
Agent + Containers]
W2[Worker Node
Agent + Containers]
P <-.WireGuard.-> W1
P <-.WireGuard.-> W2
W1 <-.WireGuard.-> W2
end
Internet -->|HTTPS| P
CP <-->|Poll| Servers
```
**Traffic Flow:**
- **Public**: Internet → Proxy Node → Traefik (TLS) → WireGuard → Container
- **Internal**: Container → DNS (.internal) → WireGuard → Container
## Architecture
See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for detailed documentation.
## TODO
- Notifications: Alert channels for deployment events and system alerts
- Templates: Pre-configured templates for popular applications