Installation

Die Voraussetzungen, die Installation, der entstehende Baum und wohin die Lizenz gehört.

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

Voraussetzungen

Zwei Dinge müssen Sie selbst beisteuern, und beide verhindern den Start, wenn sie fehlen: die .NET-10-Laufzeit in x86 und Ihre Lizenz.

• .NET 10 Runtime, Variante x86. FoxServer ist 32-bittig, und das ist keine Vorliebe: er lädt das COM von Visual FoxPro, und das ist es. Die x64-Laufzeit nützt nichts, auch wenn sie installiert ist, und fehlt die 32-Bit-Variante, bietet der Installer an, sie herunterzuladen und zu installieren (ab 0.9.27: etwa 28 MB von Microsoft, die Signatur wird vor dem Ausführen geprüft). Wer es lieber von Hand macht, lädt sie direkt hier dotnet-runtime-win-x86.exe. Es ist die normale „.NET Runtime“: weder die ASP.NET-Core- noch die Desktop-Variante wird gebraucht.
• Windows 10 oder neuer, 32 oder 64 Bit.
• Auf dem Rechner, auf dem Sie entwickeln, die IDE von Visual FoxPro 9 SP2: init, controller-add und build brauchen sie. Auf dem Rechner, von dem aus Sie ausliefern, nicht: dort genügen die VFP-9-Laufzeiten neben Ihrer MTDLL.
• Administratorrechte zum Installieren und zum Anmelden des Dienstes. Und eine erhöhte Konsole für build: BUILD MTDLL registriert am Ende die Coclass.

Installation

1. Den Installer herunterladen. FoxServer-Setup-<Version>.exe, aus der Detailansicht Ihrer Lizenz im Portal. Der Dateiname trägt die Version, und die vom Portal angebotene ist die, auf die Ihre Wartung Anspruch gibt.
2. Als Administrator ausführen. Nötig, um SecurityHelper.comhost.dll für COM zu registrieren und den Windows-Dienst anzumelden. Es wird keine Umgebungsvariable geschrieben und der Systempfad nicht angefasst: die CLI und der Host finden sich selbst, ausgehend von dem Ordner, in dem sie liegen.
3. Den Ordner wählen. Voreingestellt ist C:\Programas\FoxServer. Bis 0.9.34 war es C:\Program Files (x86)\FoxServer, und ein Update bleibt in dem Ordner, den es schon hatte. Sie können installieren, wohin Sie wollen, aber flachen Sie den Baum nicht ab: liegt config\ nicht mehr neben bin\, stirbt der Start am Lizenztor, ohne zu sagen, dass die Struktur das Problem war.
4. Das Häkchen für den Dienst stehen lassen. Es ist gesetzt, und auf einem frischen Rechner ist das richtig. Hatte der Rechner den Dienst schon und haben Sie in einen anderen Ordner installiert, wird er nicht ersetzt: zu korrigieren mit sc config FoxServer binPath= "<neu>\bin\FoxServer.Host.exe --service".
5. Ihre Lizenz kopieren. Nach config\foxserver.lic, in den gewählten Ordner. Sie liegt dem Installer nicht bei und kann es nicht: ein JWT trägt Inhaber und E-Mail und wird je Kunde ausgestellt.

Unbeaufsichtigter Modus

Für die Verteilung über ein Verwaltungswerkzeug. /LIC ist von uns und kopiert die Lizenz nach config\; die anderen drei stammen von Inno Setup. Unbeaufsichtigt öffnet sich kein Dialog, und die abschließende Prüfung läuft nicht: holen Sie sie mit verify.cmd nach.

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

Das Einzige, was auch unbeaufsichtigt ein Hindernis bleibt, ist eine fehlende .NET-10-x86-Laufzeit: da hält er ohne Rückfrage an, mit Absicht, weil ein Server womöglich keinen Internetzugang hat. Hat er einen, fügen Sie /DOTNET=descargar hinzu, und er lädt und installiert sie selbst.

Wenn FoxServer schon installiert war

Mit dem Installer ist nichts zu tun: er hält den Dienst an und startet ihn am Ende wieder, falls er lief. Entpacken Sie stattdessen das ZIP darüber, halten Sie den Dienst vorher an (net stop FoxServer): solange er läuft, hält er FoxServer.Host.exe und seine DLLs geöffnet, und das Kopieren scheitert an genau diesen Dateien.

Die Demo (seit 0.9.28)

Der Installer hat ein Kontrollkästchen, angehakt, das eine Demo installiert und am Ende im Browser öffnet: http://127.0.0.1:8099/, ein Laden mit DBF-Daten als REST-API und als Webseite, neben jedem Ergebnis der VFP-Code, der es erzeugt. Sie funktioniert ohne Lizenz: ohne config\foxserver.lic liefert FoxServer nur die Demo aus, und nur an diesen Rechner. Sie liegt in demo\; zum Abschalten "active": false in config\servers\foxserver-demo-api.json und foxserver-demo-web.json. Unbeaufsichtigt wird sie nur mit /DEMO=1 installiert.

Der Baum, der Teil des Vertrags ist

<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

Die Lizenz

Sie wird im Portal heruntergeladen, in der Detailansicht der Lizenz. Die E-Mail meldet nur, dass sie bereitsteht: die Datei hängt nicht an. Kopieren Sie sie nach config\foxserver.lic, in den Ordner, in den Sie installiert haben. Der Server sucht sie neben dem bin\, aus dem er startet. Ohne sie startet der Host und bleibt am Tor stehen: er liefert nichts aus.

Prüfen, ob es läuft

Am gründlichsten ist install.cmd: es prüft die Voraussetzungen, nimmt Inventar des Deklarierten auf und verifiziert wirklich – es startet den Server, schickt ihm eine HTTP-Anfrage und fährt ihn herunter, und hält beim ersten Fehler an. Von Hand:

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

So etwas sollte erscheinen:

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

Wenn etwas schiefgeht

Weiter: Erste Schritte →