Requirements.
Server requirements for running VoxelBooking. Any standard PHP hosting works.
Requirements
VoxelBooking runs on standard PHP hosting. No exotic dependencies.
Browser & device
The admin panel and public booking pages work in any modern browser - Chrome, Firefox, Safari, Edge. The admin panel is responsive and works on tablets and phones, though a wider screen is more comfortable for calendar and settings views.
Server requirements
| Requirement | Minimum |
|---|---|
| PHP | 8.3 or higher |
| Database | MySQL 8.0 or higher (InnoDB, utf8mb4) |
| Web server | Apache with mod_rewrite enabled |
| Disk space | 50 MB for VoxelBooking + space for uploads |
Required PHP extensions
These extensions are checked during installation. All are standard on modern PHP hosting:
| Extension | Purpose |
|---|---|
| PDO MySQL | Database storage |
| cURL | Email sending, external requests |
| JSON | Data parsing |
| mbstring | Text processing |
| fileinfo | File type detection |
| OpenSSL | Password hashing, encryption |
| GD | Image handling (logos, covers) |
| Zip | In-admin updates |
Recommended PHP settings
| Setting | Recommended |
|---|---|
memory_limit |
128M or higher |
upload_max_filesize |
10M or higher |
max_execution_time |
30 (default is fine) |
Writable directories
The web server must be able to write to these directories:
storage/logs- application logspublic/uploads- business logos, cover images, and other uploads
The installation wizard checks these permissions in Step 1.
Web server configuration
Apache
VoxelBooking ships a root .htaccess that handles everything:
- Rewrites all requests into
public/ - Blocks direct access to application directories (
app/,config/,storage/,.env) - Prevents directory listing
No document root changes required. Works out of the box on any Apache host with mod_rewrite enabled.
Recommended hosting
VoxelBooking works on shared hosting, VPS, or any cloud server that meets the requirements above.
- Shared hosting - Any cPanel or Plesk host with PHP 8.3+ and MySQL 8.0+ (Hostinger, Namecheap, A2 Hosting, SiteGround)
- VPS - DigitalOcean, Hetzner, Vultr, Linode (with Apache installed)
Shared hosting note: Most shared hosts meet all requirements out of the box. The installation wizard tells you if anything is missing.
See also
- Installation - clone the repository or upload a release archive, then run the wizard
- Updating - pull with Git or apply a release archive
Ready to build?
Open source. Self-hosted. Full source code.