Tired of heavy, bloated local development stacks? Portable Tiny Webserver is a lightweight, fully self-contained local development environment for Windows. Built using Nginx, PHP, and MariaDB, it runs entirely out of a single directory with zero Windows registry bloat—making it completely portable across drives or machines.
📂 Directory Structure
To get started, create a root directory (for example, D:\www\). Inside this folder, organize your components as follows:
/app— Your web application source code directory./db— Contains your database manager (includes a DB admin script and theDB-Admin-Migration-Manual.pdf)./sys— Houses all core server binaries and configuration files.
🛠️ Step 1: Download & Extract Binaries
Download the required Windows executables and extract them into their respective directories under /sys/:
MariaDB (v12.3.3): Extract into
D:\www\sys\mariadb\mariadb12.3.3(Reference:
MariaDB 12.3.3 Release Notes )PHP (v8.5.10): Extract into
D:\www\sys\php\php8.5.10Nginx (v1.30.5): Extract into
D:\www\sys\nginx\nginx-1.30.5(Reference:
Nginx 1.30.5 Release )
⚙️ Step 2: Configuration
Locate the configuration directory at
sys\conf\.Ensure all three
.ini/.conffiles are placed here.Important: Update the paths inside all configuration files to match your custom root directory path (e.g., changing
D:/www/to match your actual installation path).
You can test your Nginx configuration via command prompt:
nginx.exe -t -c D:/www/sys/conf/nginx.conf
🚀 Step 3: Initialize & Run
1. Initialize the Database
Make sure the sys/data directory is completely empty before running this step (run only once):
cd /d D:\www\sys\mariadb\mariadb12.3.3\bin
mariadb-install-db.exe --datadir="D:/www/sys/data"
2. Start and Stop the Server
To Start: Run
start.exeTo Stop: Run
stop.exe
🗄️ Step 4: Database Setup & Management
Read
db/DB-Admin-Migration-Manual.pdfto learn how to set up database passwords and adjust security settings (Default password:admin123).Open your browser and navigate to
http://localhost:8080/db/to configure your application's database using the built-in single-database manager.
Enjoy your ultra-fast, portable Nginx/PHP/MariaDB development environment and start building apps instantly!