Deploy VoxelSite for everyone.
VoxelSwarm is a free, open-source deployment layer that turns one VoxelSite installation into a multi-tenant platform. Each user gets their own isolated hosting account, their own AI website builder, their own API key. No SaaS. No shared infrastructure. No middlemen.
⚠️ Early Access — VoxelSwarm requires extensive testing across different hosting environments and control panels. Please read docs/testing-feedback.md before reporting issues. A regular VoxelSite license is all you need for testing.
You could run VoxelSite as a centralized SaaS — one app, shared database, monthly subscriptions. But:
- You'd need to build and maintain a multi-tenant codebase
- You'd handle all user data (GDPR, compliance, security breaches)
- One shared AI API key — one user violating terms gets your entire platform suspended
- Billing, subscriptions, churn — revenue depends on retaining paying users month to month
- One bug affects everyone
VoxelSwarm takes a different approach. Each client gets a full, isolated VoxelSite installation. Each brings their own AI API key. One VPS, one license, predictable costs. No billing system needed — charge per project, per month, or give it away. Your business model.
git clone https://github.com/NowSquare/VoxelSwarm.git
cd VoxelSwarmThat's it — all dependencies are included in the repo. No composer install or npm install needed.
Point your domain to the VoxelSwarm directory (see installation docs for Nginx/Apache config).
Then open https://yourdomain.com in your browser — VoxelSwarm detects it's not installed and launches the setup wizard automatically.
The wizard runs system checks, then lets you configure your domain, operator account, control panel adapter, and email — all from the browser. No SSH required.
CLI alternative:
php scripts/install.php
Upload your VoxelSite ZIP (purchased from CodeCanyon) to template/voxelsite/ and process it from the Templates page in the operator dashboard.
This extracts VoxelSite, moves the image library to a shared location (saving ~15 MB per instance), and generates the image manifest. ZIPs can have any filename — VoxelSwarm reads the VERSION file inside.
CLI alternative:
php scripts/prepare-template.php /path/to/voxelsite.zip
By default, VoxelSwarm runs in operator-only mode — GET / redirects to the operator login. You provision instances from the dashboard at /operator. When you're ready for public self-service signups, enable the public site in Deployment settings.
- PHP 8.2+ with extensions:
pdo_sqlite,mbstring,openssl,fileinfo,zip,curl - Web server: Nginx (recommended) or Apache with
mod_rewrite - Wildcard DNS:
*.yourdomain.com → your server IP(only for Nginx adapter — Forge, cPanel, and Plesk handle this automatically) - Wildcard SSL: for
*.yourdomain.com(only for Nginx adapter — other adapters provision SSL per-subdomain) - VoxelSite license: voxelsite.com/buy
- No MySQL. No Node.js. No Redis. No Composer required —
vendor/is included in the repo.
VoxelSwarm uses an adapter system to create hosting accounts and configure your control panel. Each adapter implements the same interface:
| Adapter | Status | Configuration |
|---|---|---|
| Filesystem (Local) | ✅ Working | docs/adapters/local.md |
| Nginx | ✅ Working | docs/adapters/nginx.md |
| Laravel Forge | 🧪 Testing | docs/adapters/forge.md |
| cPanel/WHM | 🧪 Testing | docs/adapters/cpanel.md |
| Plesk | 🧪 Testing | docs/adapters/plesk.md |
| DirectAdmin | 📋 Planned | docs/adapters/directadmin.md |
| CloudPanel | 📋 Planned | docs/adapters/cloudpanel.md |
| HestiaCP | 📋 Planned | docs/adapters/hestiacp.md |
| CyberPanel | 📋 Planned | docs/adapters/cyberpanel.md |
Missing your panel? Open an issue or contribute an adapter.
VoxelSwarm/
├── index.php # Front controller
├── src/
│ ├── Adapters/ # Control panel adapter system
│ ├── Controllers/ # Route handlers
│ ├── Models/ # SQLite data access
│ ├── Services/ # Provisioner, mailer, health checker
│ ├── Middleware/ # Auth, CSRF, throttle
│ └── Helpers/ # Encryption, validation, response
├── views/ # PHP templates
├── migrations/ # SQLite schema
├── scripts/ # install.php, prepare-template.php, migrate.php
├── storage/
│ ├── swarm.db # SQLite database
│ ├── instances/ # Provisioned VoxelSite installations
│ └── logs/ # Provisioning + system logs
├── template/voxelsite/ # Prepared VoxelSite template
└── library/ # Centralized image library
Two users, one platform:
- The Operator — installs VoxelSwarm, configures the adapter, manages instances from the dashboard
- The Tenant — signs up, gets a hosting account, builds their website with AI
| Topic | Link |
|---|---|
| Installation | docs/installation.md |
| Configuration | docs/configuration.md |
| Page Map | docs/page-map.md |
| Testing & Feedback | docs/testing-feedback.md |
| Template Preparation | docs/template-preparation.md |
| Operator Dashboard | docs/operator-dashboard.md |
| Adapters Overview | docs/adapters/README.md |
| Writing an Adapter | docs/adapters/writing-an-adapter.md |
| Troubleshooting | docs/troubleshooting.md |
| Updating | docs/updating.md |
VoxelSwarm itself is free and open source (MIT License).
To deploy instances, you need a VoxelSite license — voxelsite.com/buy.
VoxelSwarm is open source because the only way to make it work on every hosting environment is to let people test it on their hosting environment. Contributions are welcome:
- Report bugs — Start with docs/testing-feedback.md, then open an issue
- Write an adapter — See docs/adapters/writing-an-adapter.md
- Fix edge cases — Every control panel has quirks. Your PR helps everyone
- Improve docs — Clearer instructions save hours of debugging
Please read CONTRIBUTING.md before submitting a pull request.
- Check the logs:
storage/logs/contains detailed, structured logs for every provisioning step, adapter call, email, and operator action. See Testing & Feedback and Troubleshooting → Log Files. - Report a bug: Start with docs/testing-feedback.md, then open an issue at github.com/NowSquare/VoxelSwarm/issues. If you are a VoxelSite customer and prefer not to share logs publicly, you can also use VoxelSite support.
- VoxelSite: voxelsite.com — for VoxelSite-specific issues (the AI builder, not VoxelSwarm)
- Multi-Site: voxelsite.com/multi-site
MIT — see LICENSE.
VoxelSite is a separate commercial product. VoxelSwarm is a deployment layer for VoxelSite, not a fork or redistribution.
VoxelSite builds the website. VoxelSwarm puts it in front of the world.