Container Cost

Docker container cost allocation tool that calculates and monitors
how much each container costs across one or many VPS instances.
Agent + Central Server architecture.

📂 View on GitHub 📖 Full Documentation 🐳 Docker Image

✨ Key Features

What Container Cost brings to your infrastructure

📊

Multi-VPS Dashboard

See total cost, per-container breakdown, and trends from all VPS in one central dashboard.

🤖

Agent Mode

Deploy lightweight agents on each VPS. They calculate costs locally and push to central server.

🧮

Weighted Cost Formula

Fair allocation based on actual resource usage: CPU 50%, RAM 40%, Storage 10%.

🔐

Role-based Auth

Three roles: Admin, Engineer, Management — different access levels.

🖥️

VPS Management

Add/remove VPS from dashboard, auto-generate API keys, online/offline monitoring.

🚀

One-liner Deploy

Deploy agents on new VPS with a single curl ... | bash command.

⚡ Quick Install

Get started in 5 minutes

Central Server

                
                    # 1. Clone & start with PostgreSQL

                    git clone https://github.com/edsuwarna/container-cost.git

                    cd container-cost

                    docker compose up -d

                    # 2. Open dashboard

                    # http://localhost:8081

                    # Login: admin / admin123

                    # 3. Add VPS → deploy agent

                    curl -fsSL https://raw.githubusercontent.com/edsuwarna/container-cost/

                    main/deploy/setup-agent.sh | bash -s -- \\

                      --server=http://YOUR_IP:8080 \\

                      --api-key=YOUR_API_KEY

                    # 4. Monitor everything from dashboard