Installing Velk puts the engine in a folder on your computer and creates its database and your admin user. With the skill, it's one request. Velk needs no Composer and no build step: PHP and a MySQL database are enough. Build on your computer first, check it, and publish later.
What Velk needs
| Piece | Requirement |
|---|---|
| PHP | 8.2 or newer, with the extensions pdo_mysql, gd, fileinfo and mbstring. |
| Database | MySQL 5.7 or newer, or MariaDB 10.3 or newer. |
| Web server | On your computer, Velk's own development server. On the hosting, Apache with mod_rewrite, or Nginx. |
Ask the AI
I need PHP 8.2 or newer and MySQL running on this computer to work with Velk. Check what's already installed and install what's missing.
On a Mac the AI uses Homebrew. On Windows it guides you through XAMPP, a graphical installer with PHP and MySQL; there, the clicks are yours.
Ask the AI
Install Velk here. The site is called Harbor Dental. Use the local MySQL (user root, no password) and create a database called harbor_dental.
Open an empty folder first. The AI asks what it can't guess and shows each step as it runs.
What it asks
| Question | What to answer |
|---|---|
| Database access | The user and password of your local MySQL. On a new setup it's usually root with no password. The AI creates the database; it only needs a way in. |
| Database name | Any name, such as harbor_dental. It's created if it doesn't exist. |
| Your admin login | Email, password (at least 8 characters) and name. This is how you sign in to the panel. |
Site address (APP_URL) | Leave it blank on your computer: Velk detects it. The real address goes in when you publish. |
| Email sending (SMTP) | Optional, and it can wait. Until it's set, the site may not send emails such as form notifications. |
What it does
-
Checks the folder
If Velk is already there, it stops and asks whether to reinstall, update or only apply what's pending. It never touches an existing
.envwithout asking. -
Downloads the official release
The latest version from
releases.velkcms.com, checked against its published fingerprint (sha256) before anything is unpacked. If they differ, the install stops. -
Writes
.envThe file with the database password and this copy's settings, readable only by your user.
-
Runs the installer
bin/velk installcreates the database if needed, applies the migrations (the database changes each version brings), creates your admin user and puts.htaccessandrobots.txtin place. -
Cleans up and records the version
It removes the setup files that have no further use and writes
.velk-version, so later updates know what's installed.
See it running
Velk brings a development server. Ask “start the site on my computer” and the AI runs bin/velk serve: the site answers at http://localhost:8080 and the panel at http://localhost:8080/admin, where you sign in with the email and password you chose. The site is up while that server runs. If another program already uses port 8080, ask for a different one; the command takes the number, as in bin/velk serve 8081.
The install stopped with a connection error.
MySQL is probably not running. On a Mac the AI runs brew services start mysql; on Windows, start MySQL in the XAMPP control panel. Then ask it to try again: it picks up where it stopped.
The AI says Homebrew needs my Mac's password.
When a Mac doesn't have Homebrew yet, its installer asks for the Mac's password, which only you can type, in the Terminal app. The AI gives you the command to paste there.
Which PHP version should I use?
8.2 or newer. If you already know the hosting, match its version: code that runs on a newer PHP can fail on an older one.
Can I install by hand?
Yes. The manual steps (the .env, bin/velk install and the web server rules) are on the Documentation page.