Instalación

Los requisitos, la instalación, el árbol que queda y dónde va la licencia.

Get-FileHash -Algorithm SHA256 "$HOME\Downloads\FoxServer-Setup-0.9.38.exe"

Requisitos

Dos cosas hay que poner tú, y las dos paran el arranque si faltan: el runtime de .NET 10 en x86 y tu licencia.

• .NET 10 Runtime, variante x86. FoxServer es de 32 bits, y no es una preferencia: carga el COM de Visual FoxPro, que lo es. El runtime x64 no sirve aunque esté instalado, y si no encuentra el de 32 bits, el instalador te ofrece bajarlo e instalarlo (desde la 0.9.27: unos 28 MB de Microsoft, con su firma comprobada antes de ejecutarlo). Si prefieres hacerlo a mano, la descarga directa es dotnet-runtime-win-x86.exe. Es el «.NET Runtime» normal: no hace falta el de ASP.NET Core ni el de escritorio.
• Windows 10 o superior, de 32 o de 64 bits.
• En la máquina donde desarrollas, el IDE de Visual FoxPro 9 SP2: init, controller-add y build lo necesitan. En la máquina donde sirves no hace falta: bastan los runtimes de VFP 9 junto a tu MTDLL.
• Administrador para instalar y para dar de alta el servicio. Y consola elevada para build: BUILD MTDLL registra la coclase al terminar.

Instalación

1. Descarga el instalador. FoxServer-Setup-<versión>.exe, desde el detalle de tu licencia en el portal. El nombre lleva la versión, y la que te ofrece el portal es la que te toca según tu mantenimiento.
2. Ejecútalo como administrador. Hace falta para registrar SecurityHelper.comhost.dll por COM y para dar de alta el servicio de Windows. No escribe ninguna variable de entorno ni toca la ruta del sistema: la CLI y el host se encuentran mirándose los pies, desde la carpeta en la que están.
3. Elige la carpeta. Por defecto C:\Programas\FoxServer. Hasta la 0.9.34 era C:\Program Files (x86)\FoxServer, y quien actualiza encima sigue en la carpeta que ya tenía. Puedes instalar donde quieras, pero no aplanes el árbol: si config\ deja de estar al lado de bin\, el arranque muere en la puerta de la licencia sin decir que el problema era la estructura.
4. Deja el alta del servicio marcada. Viene marcada, y en una máquina limpia es lo que quieres. Si la máquina ya tenía el servicio y has instalado en otra carpeta, el alta no lo reemplaza: se corrige con sc config FoxServer binPath= "<nueva>\bin\FoxServer.Host.exe --service".
5. Copia tu licencia. A config\foxserver.lic, dentro de la carpeta que elegiste. No viaja en el instalador y no puede: un JWT lleva titular y correo, y se emite por cliente.

Modo desatendido

Para desplegarlo con una herramienta de gestión. /LIC es nuestro y copia la licencia a config\; los otros tres son de Inno Setup. En desatendido no se abre ningún diálogo y la comprobación final no se lanza: pásala luego con verify.cmd.

FoxServer-Setup-0.9.38.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART ^
    /LIC="C:\ruta\foxserver.lic"

Lo único que sigue siendo un impedimento en desatendido es que falte el runtime de .NET 10 x86: ahí se para sin preguntar, a propósito, porque un servidor puede no tener salida a internet. Si la tiene, añade /DOTNET=descargar y lo baja e instala él.

Si ya tenías FoxServer instalado

Con el instalador no hay que hacer nada: para el servicio y lo vuelve a arrancar al acabar si estaba en marcha. Si descomprimes el ZIP encima, para el servicio antes (net stop FoxServer): mientras corre tiene abiertos FoxServer.Host.exe y sus DLL, y la copia falla sobre esos ficheros.

La demo (desde la 0.9.28)

El instalador trae una casilla, marcada, que instala una demo y la abre en el navegador al terminar: http://127.0.0.1:8099/, una tienda con datos DBF servida como API REST y como página, con el código VFP que la produce al lado de cada resultado. Funciona sin licencia: sin config\foxserver.lic, FoxServer sirve solo la demo, y solo a esta máquina. Vive en demo\; para apagarla, "active": false en config\servers\foxserver-demo-api.json y foxserver-demo-web.json. En desatendido no se instala, salvo con /DEMO=1.

El árbol, que es parte del contrato

<raiz de la instalacion>\        por defecto C:\Programas\FoxServer\
  bin\          el host. LA RAIZ ES LA CARPETA PADRE DE ESTA
    FoxServer.Host.exe          el servidor
    FoxServer.Core.dll
    SecurityHelper.comhost.dll  se registra con el regsvr32 de 32 bits
    Interop.vfp9.dll
    vfpTemplate.txt             obligatorio si hay algun sitio "web"
    Nexum.dll  Newtonsoft.Json.dll  System.Management.dll  ...
  config\       foxserver.lic + servers\*.json (un manifiesto por servidor)
  logs\         FoxServer_<fecha>.log, uno por dia, partido a 10 MB
  cli\          foxserver.exe: crear y compilar proyectos sin abrir el IDE
  ide\          FoxForge.APP + providers\web\: el taller, dentro del IDE de VFP
  ejemplos\     los ejemplos de la guia, ejecutables
  tools\        requisitos, inventario y verificacion
  foxforge.cmd  abre FoxForge en el IDE de VFP 9
  install.cmd   comprueba, inventaria y verifica de verdad
  verify.cmd    la verificacion sola

La licencia

Se descarga del portal, en el detalle de la licencia. El correo que recibes avisa de que ya está: no lleva el fichero adjunto. Se copia a config\foxserver.lic, dentro de la carpeta donde instalaste. El servidor la busca junto al bin\ del que arranca. Sin ella el host arranca y se para en la puerta: no sirve nada.

Comprobar que funciona

Lo más completo es install.cmd, que comprueba los requisitos, hace inventario de lo declarado y verifica de verdad: levanta el servidor, le hace una petición HTTP y lo apaga, parando en el primer falló. A mano:

cd "C:\Programas\FoxServer\bin"
FoxServer.Host.exe

Tiene que salir algo así:

2026-09-20 09:15:02.114 INFO  FoxServer 0.9.38, console mode
2026-09-20 09:15:02.201 INFO  VFP pool: 2 STA threads, timeout 120 s, queue 16, admission slots 50 (defaults)
2026-09-20 09:15:02.203 INFO  License: Runtime, Tu Empresa, S.L., 1 seat(s), maintenance until 2027-01-15 (active)
2026-09-20 09:15:02.350 INFO  salesapi: docs at GET /openapi.json and GET /docs
2026-09-20 09:15:02.402 INFO  salesapi [api] listening on http://127.0.0.1:8099/
2026-09-20 09:15:41.870 INFO  GET /api/customers 200 26 ms  salesapi  127.0.0.1

Si algo va mal

Siguiente: Primeros pasos →