Repository navigation
Releases
Releases · ASP-NET-Web-Forms-Club/Hearth-ASPNET-Server
Hearth Portable Web Server 1.6
Hearth Portable Web Server 1.6
Downloads
| Download Package | Size | Best For |
|---|---|---|
| Hearth-Portable-Web-Server-v1.6-Bundled-PHP-Python-NodeJS.zip | 90.5 MB | All-in-One Bundle (Recommended) Includes ASP.NET (built-in default) plus pre-configured, portable PHP, Python, and Node.js runtimes and sample demo sites. Works out of the box with zero installation. |
| Hearth-Portable-Web-Server-v1.6.zip | 224 KB | Lightweight Launcher Only Supports ASP.NET out of the box. Best if you only host ASP.NET apps, or if you already have PHP, Python, Node.js, or .NET Core installed on your machine (or prefer to supply your own runtime paths). |
Quick Start
Extract the .zip archive to any folder and run one of the following:
HearthPortableWebServer.Manager.exe— Multi-site manager (ASP.NET, PHP, Python, Node.js, .NET Core)HearthPortableWebServer.Launcher.exe— Single-site launcher (ASP.NET)
Bundled Runtimes (All-in-One Edition)
No installation needed—ready to run immediately after unzipping:
| Folder | Runtime |
|---|---|
runtimes\php\ |
PHP 8.4.27 NTS x64 (php.ini included; VC++ 2015–2022 runtime DLLs included) |
runtimes\python\ |
Python 3.14.10 embeddable + pip (runtimes\python\python.exe -m pip install <pkg>) |
runtimes\node\ |
Node.js v26.13.0 LTS + npm |
Sample Sites (All-in-One Edition)
Pre-configured in manager_sites.json:
| Port | Site | Folder |
|---|---|---|
8080 |
ASP.NET Demo | sites\aspnet-demo |
8081 |
PHP Demo | sites\php-demo |
8082 |
Python Demo | sites\python-demo |
8083 |
Node.js Demo | sites\node-demo |
Runtime Resolution Order
When the Exe (opt) path is left empty in the site configuration, Hearth resolves the runtime automatically in this order:
- Custom EXE path (if set in the site configuration)
- Project virtual environment (
.venvorvenv, for Python) - Bundled runtime in
runtimes\<engine>\ - System
PATH
Windows Service Support (Auto-Start on Boot)
Normally, you start servers manually from the GUI while logged into Windows. Installing as a Windows Service lets your sites:
- Start automatically when Windows boots (Session 0, before any user logs in)
- Keep running in the background after you close the GUI or log out
- Recover automatically if a site process crashes (when using the Manager Service)
Both tools include one-click Windows Service installation (prompts for Admin/UAC):
- Multi-Site Manager (
HearthPortableWebServer.Manager.exe): Click Windows Service (Boot) → Install Service. This installsHearthManagerService, a background watchdog that starts and monitors every site marked "Auto-start on machine boot / service launch". You can still openManager.exeat any time as a dashboard to view status, start or stop sites, or edit configs. - Single-Site Launcher (
HearthPortableWebServer.Launcher.exe): Click Install Service. This installs a dedicated service for that ASP.NET site and port (HearthPortableWebServer_Port<N>) so it starts on boot without openingLauncher.exe.
Tip: Use either the Manager Service or the Single-Site Launcher Service for a given port, not both at the same time.
Licenses (All-in-One Bundled Runtimes)
- PHP:
runtimes\php\license.txt(PHP License) - Python:
runtimes\python\LICENSE.txt(PSF License) - Node.js:
runtimes\node\LICENSE(MIT) - VC++ Runtime DLLs: Redistributed under the Microsoft Visual C++ Redistributable terms.