cloudness

Cloudness

An open-source & self-hostable alternative to Heroku / Netlify / Vercel for 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

• 📖 Documentation
• 💬 GitHub Discussions
• 🐛 Issue Tracker

🛠️ 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

🤝 Contributing

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

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. 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

🗺️ Roadmap

• Enhanced monitoring and observability
• Multi-cloud support
• Advanced deployment strategies (canary, blue-green)
• Marketplace for community templates
• GitOps integration
• Cost optimization features

📄 License

This project is licensed under the Apache License 2.0, see LICENSE.

🙏 Acknowledgments

Built using:

• Go
• Kubernetes
• Templ
• Alpine.js
• Tailwind CSS
• Drone SCM

Made with ❤️ by the Cloudness team