IR
irwinrodriguez.dev
Back to docs

Installation

This guide covers the requirements, installation process and license activation for FoxServer.

System requirements

ComponentMinimumRecommended
Visual FoxPro9.0 SP2VFP 9 SP2 / VFP 10.1
WindowsWindows 10Windows 10 / 11 (64-bit)
.NET Framework4.7.24.8
RAM4 GB8 GB+
Disk space500 MB1 GB+
PermissionsAdministrator (for installation)

Installation process

1. Download the installer

Download FoxServer_Setup.exe from your customer portal (Downloads section) or from the product page.

2. Run as Administrator

Right-click the installer and select "Run as Administrator". This is required to register COM components and configure environment variables.

3. Follow the wizard

The installer creates the directory structure, registers components and configures the system path.

Directory structure

C:\Program Files\FoxServer\
├── bin\
│   ├── FoxServer.exe
│   ├── Newtonsoft.Json.dll
│   ├── SecurityHelper.dll
│   └── logs\
├── config\
│   ├── foxserver.lic          <-- your license file
│   └── servers\               <-- project configs
└── logs\

4. Place the license file

Download your .lic file from the customer portal and place it at the indicated path. See the Licensing section.

License activation

After purchase, you will receive a .lic file by email. You can also download it from the portal in the Licenses section.

  1. Download your foxserver.lic file from the portal.
  2. Copy the file to: C:\Program Files\FoxServer\config\foxserver.lic
  3. Restart FoxServer.
  4. The server displays license information in the console on startup.
The license does not require an internet connection to operate.

5. Verify the installation

Open a command window and run the server to verify everything works.

Verification

Open a terminal and run:

cd "C:\Program Files\FoxServer\bin"
FoxServer.exe

You should see something similar to:

FoxServer v0.7.0 — Starting...
License: Commercial — Irwin Rodriguez
Maintenance: Active (expires 2027-01-15)
Loading servers...
  [salesapi] Listening on http://0.0.0.0:8080
Ready.

Common issues

IssueCauseSolution
Error: Administrator privileges requiredInstaller ran without adminRight-click > Run as Administrator
.NET Framework not foundRuntime not installedDownload .NET Framework 4.8 from Microsoft
License validation failedMissing or incorrect .lic fileDownload the correct .lic from the portal and place in config/
Port 8080 already in useAnother service using the portChange port in server configuration
DLL load errorMissing dependencyReinstall; verify all DLLs in bin/ are present

Next: Quick Start →