Instalar Velk es poner el motor en una carpeta de tu computadora y crear su base de datos y tu usuario del panel. Con la skill, es un solo pedido. Velk no usa Composer ni paso de compilación: bastan PHP y una base de datos MySQL. Construye primero en tu computadora, revisa y publica después.
Qué necesita Velk
| Pieza | Requisito |
|---|---|
| PHP | 8.2 o más reciente, con las extensiones pdo_mysql, gd, fileinfo y mbstring. |
| Base de datos | MySQL 5.7 o más reciente, o MariaDB 10.3 o más reciente. |
| Servidor web | En tu computadora, el servidor de desarrollo del propio Velk. En el hosting, Apache con mod_rewrite, o Nginx. |
Pídele a la IA
Necesito PHP 8.2 o más reciente y MySQL funcionando en esta computadora para trabajar con Velk. Revisa qué hay instalado e instala lo que falte.
En Mac, la IA usa Homebrew. En Windows te guía con XAMPP, un instalador gráfico con PHP y MySQL; ahí, los clics son tuyos.
Pídele a la IA
Instala Velk aquí. El sitio se llama Clínica Sol. Usa el MySQL local (usuario root, sin contraseña), crea la base de datos clinica_sol y deja el panel en español.
Abre antes una carpeta vacía. La IA pregunta lo que no puede adivinar y muestra cada paso mientras lo ejecuta.
Qué pregunta
| Pregunta | Qué responder |
|---|---|
| Acceso a la base de datos | El usuario y la contraseña de tu MySQL local. En una instalación nueva suele ser root, sin contraseña. La IA crea la base de datos; solo necesita una forma de entrar. |
| Nombre de la base de datos | Cualquier nombre, como clinica_sol. Si no existe, se crea. |
| Tu acceso al panel | Correo, contraseña (al menos 8 caracteres) y nombre. Con ellos entras al panel. |
Dirección del sitio (APP_URL) | Déjala en blanco en tu computadora: Velk la detecta. La dirección real se pone al publicar. |
| Envío de correo (SMTP) | Opcional, y puede esperar. Hasta configurarlo, el sitio puede no enviar correos, como los avisos de formularios. |
Qué hace
-
Revisa la carpeta
Si ya hay un Velk ahí, se detiene y pregunta si reinstalar, actualizar o solo aplicar lo pendiente. Nunca toca un
.envexistente sin preguntar. -
Descarga la versión oficial
La más reciente, de
releases.velkcms.com, comprobada contra su huella publicada (sha256) antes de descomprimir nada. Si no coincide, la instalación se detiene. -
Escribe el
.envEl archivo con la contraseña de la base de datos y los ajustes de esta copia, que solo tu usuario puede leer.
-
Ejecuta el instalador
bin/velk installcrea la base de datos si hace falta, aplica las migraciones (los cambios de base de datos que trae cada versión), crea tu usuario del panel y coloca.htaccessyrobots.txt. -
Limpia y anota la versión
Quita los archivos de instalación que ya no sirven y escribe
.velk-version, para que las próximas actualizaciones sepan qué está instalado.
Verlo funcionando
Velk trae un servidor de desarrollo. Pide “inicia el sitio en mi computadora” y la IA ejecuta bin/velk serve: el sitio responde en http://localhost:8080 y el panel en http://localhost:8080/admin, donde entras con el correo y la contraseña que elegiste. El sitio está disponible mientras ese servidor siga en marcha. Si otro programa ya usa el puerto 8080, pide otro; el comando acepta el número, como en bin/velk serve 8081.
La instalación se detuvo con un error de conexión.
Lo más probable es que MySQL no esté en marcha. En Mac, la IA ejecuta brew services start mysql; en Windows, inicia MySQL en el panel de XAMPP. Luego pídele que lo intente de nuevo: retoma donde se quedó.
La IA dice que Homebrew necesita la contraseña de mi Mac.
Cuando tu Mac aún no tiene Homebrew, su instalador pide la contraseña de tu Mac, que solo tú puedes escribir, en la aplicación Terminal. La IA te da el comando para pegar ahí.
¿Qué versión de PHP uso?
8.2 o más reciente. Si ya sabes cuál es el hosting, usa su misma versión: el código que funciona en un PHP más nuevo puede fallar en uno más antiguo.
¿Puedo instalar a mano?
Sí. Los pasos manuales (el .env, bin/velk install y las reglas del servidor web) están en la página Documentación.