Table of contents

• ❔ What is this?
• 📌 Installation
• 🔨 Building from source
• 📘 Licences
• 📷 Screenshots

❔ What is this?

Makoon is a web application designed to make managing Kubernetes clusters in Proxmox VE as simple as possible. With Makoon, users can manage MicroK8s multi-node clusters, Helm applications, and install/uninstall Kubernetes resources without the need for complicated bash scripts, terraform or ansible.

Key Features:

• Easy management of MicroK8s multi-node clusters
• User-friendly dashboard for managing Kubernetes resources
• Seamless integration with Helm applications
• Install/uninstall Kubernetes resources directly from the dashboard
• Support for multiple Proxmox VE nodes

Additional information

• Tested with Proxmox: 8.2.2
• Supported MicroK8s versions:
  • 1.28/stable
  • 1.27/stable
  • 1.26/stable
  • 1.25/stable
  • 1.24/stable
• Support Ubuntu cloud images:
  • Ubuntu Server 22.04 LTS (Jammy Jellyfish)

📌 Installation

Docker

# Create volume for Makoon data
docker volume create makoon_db
# Run container
docker run -d --name makoon -p8080:8080 --volume makoon_db:/app/data docker.io/sieradzki/makoon:latest

Docker compose

services:
  makoon:
    image: docker.io/sieradzki/makoon:latest
    ports:
      - 8080:8080
    volumes:
      - makoon_db:/app/data
volumes:
  makoon_db:

🔨 Building from source

To build a production package, run

docker build -t makoon:local .

📘 Licences

Makoon can be used under two licences:

For personal use PolyForm Noncommercial License 1.0.0

Internal Business Use PolyForm Internal Use License 1.0.0

Can I use Makoon?

• Can I use Makoon for personal project?
  Yes.
• Can I use Makoon for commercial project?
  Yes, if you sell own software managed by Makoon, not Makoon itself.
• Can I use Makoon commercially as a service (SaaS)
  No. You are not allowed to sell or provide to your customers this software as a service. If you are interested in this kind of use, contact me.

📷 Screenshots