One file. Drop it on your server. Open your browser. Webkernel is installed.
No command line. No Git. No Composer knowledge needed. The installer handles everything.
- Download index.php and upload it to your server's web root or
public/folder. - Open your domain:
https://yourdomain.com - Navigate to:
https://yourdomain.com/fresh-install - Follow the steps on screen.
- Delete
index.phpwhen the installer tells you to. Security matters.
The installer creates its own
.htaccessrouting file automatically on first visit. Nothing to configure.
php index.php
# Install into a specific folder:
php index.php --dir /var/www/mysite| Requirement | Version |
|---|---|
| PHP | 8.4 or newer |
| PHP extensions | json, zip, openssl, curl, mbstring, pdo, tokenizer |
| Disk space | ~500 MB |
| Composer | Downloaded automatically if missing |
Not sure? The installer checks your environment and shows you exactly what's missing — before touching anything.
- Close the tab mid-install? No problem. Progress is saved on the server. Come back and refresh — it picks up where it left off.
- Multiple attempts? All previous sessions are listed in the sidebar. Resume any of them or start fresh.
- Password protection? Set a password from the installer UI so nobody else can access it while it's live. A one-time recovery key is shown when you set it — keep it somewhere safe.
| Problem | Fix |
|---|---|
404 on /fresh-install |
Apache mod_rewrite may be disabled. Ask your host to enable it, or check your Nginx config. |
| Composer times out | Use the terminal method — no time limit applies. |
| Forgot installer password | Click Forgot password? Use recovery key at the lock screen. |
| Memory error | Add memory_limit = 512M to php.ini |
Still stuck? Open an issue on GitHub.
See README.dev.md for architecture, session internals, Composer integration, security implementation, and theming.