Saltar al contenido
AnaquelIA Manuales

Manuales Instalación y primer arranque

Instalación y primer arranque

Actualizado el 31 de octubre de 2026 · Ver en Markdown

Paso a paso#

Instalar Anaquelia en la computadora de la tienda#

  1. Ejecuta Anaquelia-Setup-<versión>.exe. Windows pedirá permiso de administrador.
  2. Si al descargar el instalador Chrome dice "Es posible que este archivo sea software malicioso", abre la lista de descargas y elige Descargar archivo sospechoso (si dice que la Navegación segura lo está revisando, espera unos segundos). Si al abrirlo aparece "Windows protegió su PC", pulsa Más información → Ejecutar de todas formas. Ambos avisos pasan mientras el instalador no esté firmado.
  3. El asistente muestra el contrato de licencia de Anaquelia (EULA). Léelo y marca Acepto el contrato para seguir. Si no lo aceptas, el instalador se cierra y no instala nada; puedes volver a ejecutarlo cuando quieras.
  4. Deja marcado Crear un acceso directo en el Escritorio. Marca Permitir que el administrador vea la tienda desde otro equipo de la red local solo si vas a monitorear desde un celular o laptop (ver Monitoreo en Red).
  5. Pulsa Instalar y al final deja marcado Abrir Anaquelia ahora.

Configurar el sistema la primera vez#

  1. Se abre el asistente de primer arranque. Escribe el nombre, teléfono y dirección del negocio.
  2. Escribe tu nombre y elige tu PIN de administrador (4 dígitos, nada fácil como 1234).
  3. Elige si quieres importar productos del catálogo precargado: ninguno, todos o por categorías. Entran con existencia 0. Si vienes de Eleventa u otro sistema, elige Vengo de otro sistema: no carga el catálogo de ejemplo y al terminar te lleva a Configuración → Importar datos (ver Migrar desde otro sistema).
  4. Opcional, pero muy recomendado: escribe la carpeta de una USB o de OneDrive/Google Drive para guardar ahí una copia de cada respaldo.
  5. Opcional: en el paso Licencia puedes pulsar Empezar prueba gratis (30 días, necesita internet) o escribir el código de compra y pulsar Activar (ver Activar la licencia del equipo). Si no quieres hacer nada ahora, pasa de largo y actívala después.
  6. Revisa que la fecha y hora de la computadora sean correctas y pulsa Terminar y entrar.

Después da de alta a tus cajeros en ⚙️ Configuración → Empleados y accesos (ver Empleados).

Activar la licencia del equipo#

Cada computadora con Anaquelia necesita su propia licencia para registrar ventas, compras y encargos. Mientras no tenga una válida, esas operaciones se bloquean; consultar el sistema y hacer respaldos sigue funcionando. La licencia se activa una sola vez por equipo.

Probar gratis 30 días. Si quieres conocer Anaquelia antes de comprar, puedes empezar una prueba gratis: tienes el sistema completo durante 30 días. Se necesita internet solo para empezar.

  • En el asistente de primer arranque, en el paso Licencia, pulsa Empezar prueba gratis. Los datos del negocio que escribiste en el paso 1 se usan para la prueba.
  • Si ya estás usando el sistema, entra como administrador, ve a ⚙️ Configuración → Respaldos y pulsa Empezar prueba gratis de 30 días en la tarjeta Licencia del equipo.
  • Cada computadora puede hacer una sola prueba. Si ya la usó, el sistema lo dice y te puedes comprar la licencia con el código de compra.
  • Durante la prueba, en Inicio aparece cuántos días te quedan. Cuando quedan 7 o menos, el aviso se pone en amarillo.
  • Al terminar los 30 días, el sistema deja de registrar ventas y compras (y encargos). Lo demás sigue igual: puedes ver tus datos, reportes y hacer respaldos.
  • Para seguir sin perder nada, compra la licencia y escribe el código de compra en la misma tarjeta (o en el paso Licencia del asistente). Tus productos, clientes, ventas y empleados se conservan: no hace falta reinstalar ni volver a capturar.

La forma más fácil es con el código de compra que recibiste al comprar Anaquelia. Tiene la forma ANQ-XXXX-XXXX-XXXX y necesita internet solo esta vez.

  1. Entra como administrador y ve a ⚙️ Configuración → Respaldos.
  2. En la tarjeta Licencia del equipo, escribe el Código de compra y pulsa Activar con internet. Anaquelia se conecta, recibe la licencia de este equipo y la guarda.
  3. Si la tarjeta dice que la licencia está activa para tu negocio, ya puedes vender. Si aparece otro mensaje, léelo: por ejemplo, que ese código ya se usó en otra computadora. En ese caso escribe a quien te vendió Anaquelia.

Sin internet: en la misma tarjeta abre ¿Sin internet? Pega la clave que te enviamos, pega la clave larga que te enviaron y pulsa Activar licencia. Antes envíales el Código de este equipo (cuatro grupos de cuatro letras o números, visible en la tarjeta) para que emitan la clave.

También puedes activarla en el paso Licencia del asistente de primer arranque. Ese paso es opcional.

Una clave copiada a otra computadora no sirve: solo funciona en el equipo para el que se emitió.

1. Requisitos#

  • Windows 10 u 11 de 64 bits. Windows 7, 8 y los de 32 bits no son compatibles.
  • 4 GB de RAM o más.
  • Microsoft Edge (viene con Windows). Si no está, se usa el navegador predeterminado.
  • No hace falta instalar nada más: Node.js viene incluido en el instalador.

2. Qué instala y dónde#

Qué Dónde
El programa C:\Program Files\Anaquelia
La base de datos y los respaldos C:\ProgramData\Anaquelia\data (respaldos en data\backups)
Registros (logs) para soporte C:\ProgramData\Anaquelia\logs
Ajustes del equipo C:\ProgramData\Anaquelia\anaquelia.env
La licencia del equipo C:\ProgramData\Anaquelia\data\licencia.txt
  • Anaquelia corre como un servicio de Windows llamado "Anaquelia": arranca solo al encender la computadora, aunque nadie haya iniciado sesión, y se reinicia solo si se cae.
  • El acceso directo Anaquelia abre el sistema en una ventana propia (Edge sin barra de direcciones). Cerrar esa ventana no apaga el sistema. Si ya está abierta y vuelves a pulsar el ícono, se trae al frente la misma ventana en lugar de abrir otra. La ventana usa un perfil de Edge propio (%LOCALAPPDATA%\Anaquelia\EdgeProfile), separado del Edge que uses para otras cosas.
  • En el Menú Inicio también hay Carpeta de respaldos de Anaquelia y Desinstalar Anaquelia.
  • La carpeta del programa es de solo lectura para los usuarios normales: un cajero o empleado no puede cambiar sus archivos. Para modificarla hace falta una cuenta de administrador de Windows.

3. El asistente de primer arranque#

Una instalación nueva arranca vacía: sin productos, ventas, clientes ni empleados, y sin datos de demostración. Mientras no exista ningún empleado, la pantalla de inicio de sesión muestra el asistente en lugar de la lista de empleados.

  • Solo se puede completar desde la misma computadora donde está instalado. Si alguien lo abre desde otro equipo de la red, ve un aviso.
  • Se completa una sola vez. En cuanto existe el administrador, el asistente ya no aparece.
  • El administrador entra directo, sin que se le pida cambiar el PIN, porque lo eligió él mismo.
  • Paso Licencia (el quinto de seis, después de Respaldo): puedes empezar la prueba gratis de 30 días, activar la licencia con el código de compra o dejarlo para después. Mientras no esté activa, no se registran ventas, compras ni encargos (ver Activar la licencia del equipo).
  • Si la carpeta de copia externa no existe o no se puede escribir, el asistente lo dice y no guarda nada hasta corregirla. Después se puede cambiar en ⚙️ Configuración → Respaldos (ver Respaldos).

4. Ajustes del equipo (anaquelia.env)#

El archivo C:\ProgramData\Anaquelia\anaquelia.env admite líneas CLAVE=valor. Las líneas que empiezan con # se ignoran. Después de cambiarlo, reinicia el servicio "Anaquelia" (o la computadora).

Clave Para qué
PORT Puerto del sistema (por defecto 3000). Cámbialo si otro programa ya usa el 3000.
HOST 0.0.0.0 permite entrar desde otros equipos de la red. Lo pone el instalador si marcaste esa casilla.
BACKUP_OFFSITE_DIR Carpeta de copia externa de respaldos. Tiene prioridad sobre la que se guarda en Configuración.
ANTHROPIC_MODEL Modelo de IA para leer facturas en PDF o foto (ver Compras).
ANAQUELIA_MODULOS_OCULTOS Módulos que no aparecen: facturacion, compras_ia, comisionista, separados por comas. Si la línea no está, en una instalación se ocultan los tres. Vacía (ANAQUELIA_MODULOS_OCULTOS=) los muestra todos. Ocultar no borra datos. Además, si el país de la tienda no es México, facturacion, comisionista y la importación de XML CFDI de Compras (cfdi_compras, solo se puede nombrar aquí) se ocultan solos.

Si el puerto está ocupado, el sistema no arranca y lo explica en el registro de C:\ProgramData\Anaquelia\logs.

5. Actualizar a una versión nueva#

  1. Ejecuta el instalador de la versión nueva encima de la que ya tienes. No hace falta desinstalar. El asistente vuelve a mostrar el contrato de licencia: también hay que marcar Acepto el contrato para actualizar.
  2. Si Anaquelia está abierto, el instalador avisa que lo va a cerrar. Si hay una venta a medio cobrar, pulsa Cancelar, termínala y vuelve a ejecutar el instalador.
  3. El instalador detiene el servicio (el sistema hace un respaldo cierre al apagarse), reemplaza el programa y lo vuelve a iniciar.
  4. La primera vez que arranca la versión nueva, antes de adaptar la base de datos, toma un respaldo antes-de-actualizar. Si algo saliera mal, se puede restaurar desde ⚙️ Configuración → Respaldos.

Tus datos, empleados, ajustes y la licencia del equipo se conservan.

6. Desinstalar#

Desinstalar Anaquelia pide cerrar la ventana de Anaquelia si está abierta (con opción de cancelar), detiene y quita el servicio, borra la regla del firewall y la carpeta del programa. No borra C:\ProgramData\Anaquelia: la base de datos, los respaldos, los registros, anaquelia.env y la licencia del equipo se quedan. Si vuelves a instalar, Anaquelia los usa de nuevo.

7. Preguntas frecuentes#

¿Cerrar la ventana apaga el sistema? No. El servidor sigue corriendo como servicio. Vuelve a abrir el acceso directo cuando quieras.

El acceso directo dice que el sistema no responde. Espera unos segundos después de encender la computadora y vuelve a intentar. Si sigue igual, abre "Servicios" de Windows, busca "Anaquelia" y pulsa Iniciar, o revisa los registros en C:\ProgramData\Anaquelia\logs.

¿Puedo usar una unidad de red (Z:) para la copia externa? No. El servicio de Windows no ve las unidades de red que conecta tu usuario. Usa una USB o una carpeta de OneDrive/Google Drive.

¿Qué pasa si no acepto el contrato de licencia? El instalador se cierra y no instala nada. Para instalar Anaquelia hay que aceptar el contrato. Puedes volver a ejecutar el instalador cuando quieras.