Cloudness

An open-source, self-hostable application platform for building and operating applications on Kubernetes.

📖 About the Project

Cloudness is an open-source & self-hostable platform for deploying and managing applications on Kubernetes.

It helps you manage your servers, applications, and databases on your own infrastructure; you only need a Kubernetes cluster. You can manage any Kubernetes cluster - cloud providers, on-premises, Raspberry PIs, and anything else.

Imagine having the ease of a cloud platform like Heroku, but with your own infrastructure. That is Cloudness.

No vendor lock-in - all configurations for your applications, databases, and services are stored as Kubernetes manifests. If you decide to stop using Cloudness, you can still manage your running resources. You lose the automations and all the magic. 🪄

📥 Installation

curl -fsSL https://get.cloudness.io/install.sh | bash

Note: Please refer to the documentation for more information about installation and configuration.

✨ Features

🚀 Easy Deployment - Deploy applications to Kubernetes with minimal configuration
🔄 CI/CD Integration - Built-in pipeline support for automated builds and deployments
📦 Template System - Pre-configured templates for common services (PostgreSQL, Redis, MySQL, Valkey)
🔐 Authentication & Authorization - Secure access control with multi-tenant support
📊 Project Management - Organize applications, environments, and deployments
📝 Real-time Logs - Stream application logs in real-time
🎯 Multi-tenant - Support for multiple organizations and projects

💬 Support

🛠️ Development

Pre-Requisites

Install the latest stable version of Node and Go version 1.21 or higher. Ensure the GOPATH bin directory is added to your PATH.

Clone the repository

git clone https://github.com/cloudness-io/cloudness.git
cd cloudness

Install required Go tools

make dep
make tools

Build

Build the Cloudness binary:

make build

Run

This project supports all operating systems and architectures supported by Go. This means you can build and run the system on your machine; docker containers are not required for local development and testing.

To start the server at localhost:8000, simply run the following command:

./cloudness server .local.env

The application will start at http://localhost:8000. The database schemas will be auto-migrated on startup.

💻 CLI

This project includes command line tools for development and running the service. For a full list of supported operations, please see:

./cloudness --help

⚙️ Configuration

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | CLOUDNESSDATABASEDRIVER | Database driver (postgres/sqlite) | postgres | | CLOUDNESSDATABASEHOST | Database host | localhost | | CLOUDNESSDATABASEPORT | Database port | 5432 | | CLOUDNESSDATABASENAME | Database name | cloudness | | CLOUDNESSDATABASEUSER | Database username | - | | CLOUDNESSDATABASEPASSWORD | Database password | - | | CLOUDNESSPUBSUBPROVIDER | Pub/Sub provider (redis/inmem) | inmem | | CLOUDNESSREDISENDPOINT | Redis endpoint (if using) | - | | CLOUDNESSREDISPASSWORD | Redis password | - | | CLOUDNESS_DEBUG | Enable debug logging | false | | CLOUDNESS_TRACE | Enable trace logging | false |

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Please read our Code of Conduct before contributing.

🏗️ Architecture

Cloudness is built with:

Backend: Go with Gin framework
Frontend: HTML/Templ/Alpine.js/Tailwindcss
Database: PostgreSQL (primary), MySQL (supported)
Cache/Pub-Sub: Redis or in-memory
Orchestration: Kubernetes

Project Structure

cloudness/
├── app/              # Application core
│   ├── auth/         # Authentication logic
│   ├── controller/   # HTTP controllers
│   ├── middleware/   # HTTP middleware
│   ├── router/       # Route definitions
│   ├── services/     # Business logic services
│   ├── store/        # Application data stores
│   └── web/          # HTML Templ frontend
├── blob/             # Blob storage interface
├── cli/              # CLI implementation
├── cmd/              # Application entrypoint
├── errors/           # Error types and handling
├── helpers/          # Utility functions
├── http/             # HTTP client utilities
├── job/              # Background job scheduler
├── k8s/              # Kubernetes manifests
├── lock/             # Distributed locking
├── logging/          # Logging configuration
├── logstream/        # Real-time log streaming
├── plugins/          # Builder and deployer plugins
├── profiler/         # Performance profiling
├── pubsub/           # Pub/Sub implementation
├── schema/           # JSON schemas
├── scripts/          # Installation and ops scripts
├── store/            # Database layer
├── templates/        # Application templates
├── types/            # Type definitions
└── version/          # Version information