Welcome to KiroCloud Docs

Learn how to build, deploy, and scale your applications with KiroCloud's infrastructure.

Why KiroCloud?

We built KiroCloud to solve the fragmentation of modern application hosting. Most developers for their PostgreSQL database, and a completely different control panel for their Discord bots.

KiroCloud unifies all of these workflows into a single, high-performance ecosystem. Built on top-tier AMD Ryzen processors and Gen4 NVMe storage, we provide bare-metal level performance with the ease of a modern serverless deployment pipeline.

Getting Started

If you're completely new to the platform, here is your path to deploying your first service:

  • Create an Account: Click the Login button in the header. We authenticate securely via Discord OAuth so there are no pesky passwords to manage.
  • Access Dashboard: Once authenticated, you will be redirected to your personal dashboard where you can manage your resource limits and active processes.
  • Deploy: Choose between a generic Docker container or a Node.js bot instance, and launch it instantly.

Platform Architecture

Infrastructure Overview

KiroCloud operates on a globally distributed edge network, designed specifically for low-latency and high-throughput. Unlike generic cloud platforms that abstract hardware into virtualization layers, our platform runs containers as close to the bare metal as possible.

The Hardware

Our European nodes (Bavaria-1, Bavaria-2) are equipped with high-clock speed processors which are critical for single-threaded workloads like Minecraft instances. Backed by DDR5 RAM and NVMe RAID-10 storage, disk I/O bottlenecks are virtually eliminated.

DDoS Protection Layer

Every packet entering the KiroCloud perimeter is filtered through our enterprise mitigation layer capable of absorbing 1.2 Tbps of malicious traffic. This ensures your services remain online 24/7 without sudden lag spikes during network attacks.

User Dashboard

Centralized Management

The KiroCloud Dashboard is the central command center for your account. Written entirely in React/Vite, it communicates directly with our secured APIs to provide real-time updates via WebSockets.

Resource Monitoring

Each service you deploy spins up an isolated container. From the dashboard, you have live visibility into CPU metrics, Memory consumption, and Disk I/O. The dashboard also features an integrated live terminal, allowing you to execute commands directly within your instances without needing external SSH keys.

Managing Team Access

Large projects require teamwork. Through the dashboard, you can invite other KiroCloud users to your project via their Discord IDs and assign them granular permissions (e.g., "View Logs Only" vs "Restart Service").

Minecraft Network

Play on our server

KiroCloud operates an exclusive, central Minecraft network, which is fully managed by our administrators. Instead of hosting our own servers, we invite our community to log in directly to our high-performance main server and play with us.

Connection data & whitelist

In order to play on the network, you usually need an activated Discord account on our community server. Once you have the appropriate role, you can connect to our network domain:

  • Server IP: kirocloud.de
  • Version: Accessible with the current current versions ( 1.8 - 1.21.11 Java and Bedrock).
  • Hardware: The server runs on our dedicated KiroCloud Infrastructure to guarantee lag-free gaming and the most stable TPS.

Events & Updates

Since the server is maintained centrally by our admin team (KiroCloud Core), regular updates and community events take place. Suggestions for new worlds or plugins can be submitted at any time via our Discord server in the support channel!

Discord Bot Hosting

Containerized Deployments

Running a Discord bot locally is easy, but keeping it online 24/7 is tough. Our CI/CD pipeline connects directly to your GitHub repository.

Supported Runtimes

We provide pre-configured docker environments for the most popular bot runtimes:

  • Node.js (v18, v20, v22) - For Discord.js and Eris.
  • Python (3.10, 3.11, 3.12) - For Discord.py and Pycord.
  • Java (17, 21) - For JDA frameworks.

Environment Variables

Never commit your tokens to GitHub! Use the "Secrets" tab in the KiroCloud Dashboard to securely inject your `DISCORD_TOKEN`, `DB_PASSWORD`, and other sensitive keys directly into the container at runtime. They are fully encrypted at rest using AES-256-CBC.

REST API Reference

Programmatic Access

Everything you can do in the dashboard, you can do via the KiroCloud REST API. This allows you to build custom automated deployments or integrate our system heavily into your own external applications.

Authentication

All API requests must include a Bearer token in the Authorization header. You can generate a permanent API token from your Security Settings in the dashboard.

# Fetch all active instances
curl -X GET https://api.kirocloud.de/v2/services \
     -H "Authorization: Bearer kct_your_api_token_here" \
     -H "Content-Type: application/json"

Response Format

The API exclusively responds with JSON. A standard successful response structure looks like this:

{
  "success": true,
  "data": {
    "status": "online",
    "cpu": "Loading...",
    "memory": "Loading..."
  },
  "timestamp": "Loading..."
}

Frequently Asked Questions

How do I upgrade or downgrade my resources?

Scaling on KiroCloud requires zero downtime. Go to your Dashboard, select your service, and modify the CPU/RAM sliders. The changes take effect upon the next routine reboot of your container.

Is there a data backup system?

Yes. KiroCloud takes daily automated snapshots of your application data and databases. These are stored on an isolated physical server array. You can manually restore from a snapshot via the dashboard up to 14 days in the past.

Why was my Discord OAuth rejected?

If you see an "Invalid OAuth2 redirect_uri" error, it means the token or configuration is momentarily out of sync. Please try clearing your cache or reloading the page. Ensure you are accessing the platform via the primary domain.