Hosting con 20% de descuento comprando por el enlace

Instalar Velk

Un pedido instala el motor, crea la base de datos y tu usuario del panel. Qué necesita Velk, qué pregunta y qué hace la IA, y cómo abrir el sitio en tu computadora.

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

PiezaRequisito
PHP8.2 o más reciente, con las extensiones pdo_mysql, gd, fileinfo y mbstring.
Base de datosMySQL 5.7 o más reciente, o MariaDB 10.3 o más reciente.
Servidor webEn 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.

Lo que ejecuta la IA en Mac
$ brew install php mysql $ brew services start mysql # revisando las versiones $ php -v $ mysql --version
Si PHP aparece como 8.1 o anterior, pide que lo actualice antes de seguir.

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

PreguntaQué responder
Acceso a la base de datosEl 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 datosCualquier nombre, como clinica_sol. Si no existe, se crea.
Tu acceso al panelCorreo, 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

  1. Revisa la carpeta

    Si ya hay un Velk ahí, se detiene y pregunta si reinstalar, actualizar o solo aplicar lo pendiente. Nunca toca un .env existente sin preguntar.

  2. 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.

  3. Escribe el .env

    El archivo con la contraseña de la base de datos y los ajustes de esta copia, que solo tu usuario puede leer.

  4. Ejecuta el instalador

    bin/velk install crea 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 .htaccess y robots.txt.

  5. 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.

Lo que ejecuta la IA
# la lista de versiones, cada una con su huella $ curl -fsSL https://releases.velkcms.com/versions.json # descarga, comprueba la huella, descomprime $ curl -fSL https://releases.velkcms.com/velk-latest.tar.gz -o velk.tar.gz $ shasum -a 256 velk.tar.gz $ tar -xzf velk.tar.gz && cp -a velk-v*/. ./ # base de datos, tablas y tu usuario del panel $ ./bin/velk install ✓ Installed.
Aparece como referencia: no escribes nada de esto.

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.