> ## Documentation Index
> Fetch the complete documentation index at: https://docs.camellapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalación

> Levantar CamellApp en local: requisitos, base de datos, Prisma y arranque.

## Requisitos

* Node.js 20 o superior (se recomienda la versión 24, la misma que usa el Dockerfile).
* npm.
* MySQL o MariaDB en local (por ejemplo, vía XAMPP).

## Clonar e instalar

```bash theme={null}
git clone https://github.com/MangoMorado/CamellApp CamellApp
cd CamellApp
npm install
```

Copia el archivo de variables de entorno de ejemplo:

```bash theme={null}
cp .env.example .env
```

Después edita `.env` con tus propios valores. El proyecto necesita varias [variables de entorno](/docs/handbook/empezar/variables-de-entorno) (conexión a la base de datos, secretos de autenticación, credenciales opcionales de Google, entre otras) para arrancar correctamente; algunas son obligatorias y otras opcionales, según qué funcionalidad se quiera usar en local.

## Base de datos

Si aún no existe, crea la base de datos en MySQL o MariaDB:

```sql theme={null}
CREATE DATABASE camellapp CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

## Prisma, migraciones y seed

Con la base de datos creada y las variables de entorno configuradas, genera el cliente de Prisma, aplica las migraciones y carga los datos iniciales:

```bash theme={null}
npx prisma generate
npm run db:migrate
npm run db:seed
```

<Warning>
  `npx prisma generate` es **obligatorio** tras clonar el repositorio o tras tocar `schema.prisma`. El cliente se genera fuera de `node_modules` (en `src/generated/prisma`), así que sin este paso el proyecto no compila.
</Warning>

Opcionalmente, crea un usuario administrador:

```bash theme={null}
npm run admin:create
```

## Arrancar

```bash theme={null}
npm run dev
```

Abre [http://localhost:3000](http://localhost:3000) para ver la aplicación en marcha.