Skip to content

Repository files navigation

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

ComponentTechnology
Control PlaneNext.js (full-stack)
DatabasePostgreSQL + Drizzle
Server AgentGo
Container RuntimePodman
Reverse ProxyTraefik
Private NetworkWireGuard

How It Works

flowchart LR
subgraph Control Plane
CP[Next.js + PostgreSQL]
end
subgraph Servers
direction TB
P[Proxy Node<br/>Traefik + Agent + Containers]
W1[Worker Node<br/>Agent + Containers]
W2[Worker Node<br/>Agent + Containers]
P <-.WireGuard.-> W1
P <-.WireGuard.-> W2
W1 <-.WireGuard.-> W2
end
Internet -->|HTTPS| P
CP <-->|Poll| Servers
Loading

Traffic Flow:

  • Public: Internet → Proxy Node → Traefik (TLS) → WireGuard → Container
  • Internal: Container → DNS (.internal) → WireGuard → Container

Architecture

See docs/ARCHITECTURE.md for detailed documentation.

TODO

  • Notifications: Alert channels for deployment events and system alerts
  • Templates: Pre-configured templates for popular applications

About

Techulus Cloud Platform

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages