FAQ
The most common questions about FoxServer installation, licensing, usage and support.
What are the system requirements?
Windows 10 or higher, .NET Framework 4.7.2 or higher, 4 GB RAM minimum. Administrator permissions are required for initial installation. VFP is only needed on the development machine.
Can I run FoxServer on Linux or macOS?
Not currently. FoxServer is built in X# on .NET Framework which only runs on Windows. A cross-platform .NET Core version is in planning.
Do I need VFP installed on the production server?
No. FoxServer is a standalone .NET server. You only need VFP on the machine where you develop the controllers. The production server only needs .NET Framework and Windows.
How do I activate my license?
Download the foxserver.lic file from the customer portal (Licenses section) and place it at C:\Program Files\FoxServer\config\foxserver.lic. Restart FoxServer. No internet required.
What's the difference between purchasing and maintenance?
Purchasing gives you a perpetual license: the version you buy works forever. Annual maintenance (optional) gives access to new versions and priority support. If you don't renew, the current version keeps working with no limitations.
Does FoxServer need the internet to operate?
No. License validation does not require an internet connection. There are no calls to external servers during installation or normal operation.
Can I run multiple servers on the same machine?
Yes. Each project has its own configuration file and port. Example: API on port 8080, Admin on port 8081. All servers are loaded when FoxServer starts.
How do I set up HTTPS?
Get a .pfx certificate, place it in the config/ directory, and in the JSON configuration set issecure: true and the certificate details. See the Configuration section.
How do I protect my endpoints with JWT?
Enable JWT in the middleware section of the JSON configuration. Create a public login endpoint that generates and returns the token. Other endpoints without 'public' in the HELP comment are protected automatically.
How do I handle errors in my controllers?
Return the appropriate HTTP code (400, 404, 500) with a descriptive JSON message. The logging middleware automatically records errors. You can use LogError() for additional messages.
How many concurrent connections can FoxServer handle?
Depends on hardware and processing complexity. The internal semaphore allows up to 50 concurrent tasks by default. Modern hardware (8-core, 16GB RAM) typically handles hundreds of simultaneous connections.
How does Hot Reload work?
Edit and save your .prg in VFP. The compiler regenerates the Interop DLL. FoxServer detects the change and reloads controllers without restarting the server. In-flight requests finish on the previous version.
Can I install FoxServer as a Windows Service?
Yes. Use FoxServer.exe --install-service --name 'ServiceName'. From Services.msc you can configure automatic startup, restart on failure and monitoring.
How do I send webhooks to external services?
Enable the webhooks middleware in the configuration. From your controller, call THIS.QueueWebhook(url, secret, event). FoxServer handles delivery, retries and HMAC-SHA256 signing.
Where are the logs?
In the directory configured in middleware.logging.path. Files are named {prefix}_YYYY-MM-DD.log and rotate daily. In Windows Service mode, they are also written to the Event Viewer.
What happens when my Trial license expires?
The server stops starting on day 31. Purchase a 1, 4 or 8 seat license and place the new .lic in config/. Your code and configuration are not modified.
Are there trial periods or refunds?
We have a free 30-day Trial license for evaluation. If you're not satisfied after purchase, we offer a 30-day money-back guarantee.
How do I get support?
With active maintenance: priority email support (response within 24-48 hours). Without maintenance: community forums and GitHub Issues.
Didn't find your answer? Contact me