Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Redline Core

Redline Core (Container Orchestration & Routing Engine) is an ultra-lightweight, single-node Platform-as-a-Service (PaaS) designed for homelabs, personal servers, and private VPS environments.

It provides an automated developer sandbox with zero-configuration build pipelines, letting you deploy your applications directly from source code effortlessly.

Features

  • Ultra-Lightweight Footprint: Built in Go (1.22+) using standard library tooling. Designed to consume <150MB memory at rest.
  • Embedded Persistence: Uses SQLite 3 in WAL mode for a blazing fast, zero-dependency embedded database.
  • Zero-Config Builds: Powered by Nixpacks, Redline Core can ingest source code and automatically build optimized OCI container images without needing a Dockerfile.
  • Docker Compose & Explicit Dockerfiles: First-class support for deploying multi-service topologies via docker-compose.yml or standard Dockerfile execution.
  • Automated TLS & Routing: Built-in dynamic edge proxy via Traefik v3 that handles reverse-proxying and Let's Encrypt automated TLS certificates instantly.
  • Persistent Storage Volumes: True stateful isolation using host-managed bind mounts that survive zero-downtime container redeployments.

Quick Start (Production)

Redline Core operates using a "Sibling Container" architecture. The fastest way to run it is using Docker Compose:

  1. Clone this repository or copy the docker-compose.yml.
  2. Spin it up:
docker-compose up -d
  1. Redline Core will bind to port 8080 (API) and Traefik will take over ports 80 & 443 for edge routing.

Local Development

For local development without needing root (sudo) privileges for storage paths, use the CORE_DATA_DIR environment variable:

# Set a local storage directory for the SQLite database and volumes
export CORE_DATA_DIR=./redline-data

# Run the Go API locally
go run ./cmd/core/main.go

Architecture Stack

  • Control Plane API: Go 1.22+
  • Database: SQLite 3 (WAL Mode)
  • Dashboard UI: SvelteKit / SPA (Work In Progress)
  • Build Engine: Nixpacks CLI
  • Container Runtime: Docker Engine API (Moby)
  • Dynamic Proxy: Traefik Proxy v3

License

MIT

About

An ultra-lightweight, single-node Platform-as-a-Service (PaaS) for homelabs and personal servers.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages