NEBULAE SDK

Ultra-light virtualization engine - 100x faster than Docker, 20MB footprint.

What Is Nebulae?

Nebulae is the lightest virtualization engine ever built. It turns any Linux device into a powerful host in seconds.

• 🔥 Create virtual environments in 10-50MB on any Linux device
• 🚀 Run unlimited apps inside 1 master environment
• 🪶 Replace Pterodactyl panels with a 20MB lightweight alternative
• 💰 Host on any VPS, Render, Railway, Koyeb, or even your phone
• ⚡ 100x faster than Docker or Pterodactyl

Run on any platform: DigitalOcean, AWS, Render, Railway, Koyeb, Oracle Free Tier, Termux, or any Linux device.

Quick Install

npm install -g nebulae-sdk

What Can You Build?

| Feature | Description | |---------|-------------| | Virtual Environments | Create isolated spaces for apps, websites, bots, game servers | | Nebulae Panel | Full Pterodactyl replacement - 20MB, 100x faster | | App Hosting | Deploy Node.js, Python, Minecraft servers instantly | | Web Hosting | Host static websites with custom domains | | Game Servers | Run Minecraft & other game servers in 10-20MB containers |

Quick Start: Virtual Environments

const { createEnv } = require('nebulae-sdk');

const env = createEnv({
    name: 'my-app',
    ram: 'unlimited',
    cpu: 'unlimited',
    storage: 'unlimited'
});

// Run anything inside it
env.run('npm install express');
env.run('node index.js');

Quick Start: Nebulae Panel (Pterodactyl Replacement)

# Install the SDK
npm install -g nebulae-sdk

# Install the panel
nebulae panel install

# Follow the prompts:
# - Domain (e.g., panel.yourdomain.com)
# - Admin email & password
# - Panel type (Root Admin, Admin, User)

# Start the panel
systemctl start nebulae-panel

# Visit your panel
http://your-server-ip:8080

That's it. A full cloud panel running in 20MB.

Run Nebulae On Your Phone (Termux)

Turn your Android phone into a cloud host:

# Install Termux from F-Droid or Play Store
# Open Termux and run:

pkg update && pkg upgrade
pkg install nodejs git python
npm install -g nebulae-sdk
nebulae panel install

# Your phone is now a cloud host!

⚠️ Termux Users: Important Notes

Nebulae uses better-sqlite3 which requires build tools on Termux:

# Install build tools first
pkg install python make gcc clang binutils sqlite

# Then install Nebulae
npm install -g nebulae-sdk

If you still get errors, use the proot-distro method:

pkg install proot-distro
proot-distro install ubuntu
proot-distro login ubuntu

# Inside Ubuntu container:
apt update
apt install -y nodejs npm git
npm install -g nebulae-sdk

Run Nebulae On Old Hardware

# Install Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm git
npm install -g nebulae-sdk
nebulae panel install

Works on:

• ✅ Old laptops (2GB RAM works)
• ✅ Raspberry Pi
• ✅ Any PC with Linux
• ✅ Any VPS
• ✅ Any cloud provider

CLI Commands

# Environment Management
nebulae env create --name my-env
nebulae env list
nebulae env delete my-env

# Panel Management
nebulae panel install
nebulae panel status
nebulae panel stop
nebulae panel start

# Server Management
nebulae server create --name my-app --type node
nebulae server list
nebulae server start my-app
nebulae server stop my-app
nebulae server delete my-app

# System
nebulae system check
nebulae --help

Supported Server Types

| Type | Description | Default RAM | |------|-------------|-------------| | node | Node.js applications | 512MB | | python | Python applications | 512MB | | minecraft | Minecraft Java Edition | 1GB |

Custom Sizes: Set any RAM, CPU, or storage. Unlimited available.

Why Choose Nebulae?

| Feature | Docker | Pterodactyl | Nebulae | |---------|--------|-------------|-------------| | Footprint | 2GB+ | 2GB+ | 20MB | | Setup Time | 15-30 min | 15-30 min | 30 seconds | | RAM Usage | 1-2GB | 1-2GB | 10-50MB | | Speed | Slow | Slow | 100x faster | | Dependencies | Docker, MySQL, Redis | Docker, MySQL, Node | Node.js only | | Cost | $$$ | $$$ | $0 | | Works on Phones | ❌ | ❌ | ✅ |

Deploy Anywhere

• ✅ DigitalOcean ($4/month droplets)
• ✅ AWS EC2 (free tier)
• ✅ Google Cloud (free tier)
• ✅ Oracle Cloud (always free)
• ✅ Render (free tier)
• ✅ Railway (free tier)
• ✅ Koyeb (free tier)
• ✅ Termux (Android phones)
• ✅ Raspberry Pi (Linux)
• ✅ Old PCs & Laptops

Requirements

• Node.js 16+
• Linux (Ubuntu/Debian recommended)
• 50MB RAM available
• 100MB storage available

That's it. No Docker. No MySQL. No Redis.

• Internal path resolution improvements
• Better cross-platform compatibility
• New: NEBULAE_HOME environment variable to customize where environments are stored

Custom Storage Location

By default, Nebulae stores environments in a sensible location for your platform. To use a custom path:

export NEBULAE_HOME=/your/custom/path

---

## Support

- 💬 [Telegram Channel](https://t.me/nebulaecloudinc)
- 👨‍💻 [Developer](https://t.me/Arch_RegeantVenice)
- 💬 [WhatsApp](https://wa.me/2348088399007) 
---

## License

MIT © Nebulae Cloud

---

**One environment. Unlimited apps. Zero waste.**