Open Server Panel Documentation
repository·main·Indexed 19 days ago
https://github.com/ospanel/openserverpanelA high-performance, portable WAMP stack for Windows providing a complete local development environment. It supports multiple simultaneous versions of PHP, MySQL, and Node.js with native performance and automatic TLS configuration. The stack includes web servers (Apache, Caddy, Nginx), databases (MySQL, MariaDB, MongoDB, PostgreSQL), runtimes (PHP, Node.js, Go), and various utilities for messaging, security, and media processing.
What's inside Open Server Panel
- Open Server Panel is a portable, high-performance WAMP-stack designed for Windows. It provides a complete development environment that allows running multiple versions of PHP, MySQL, and Node.js simultaneously without virtualization. It is designed for fullstack development, offering native performance and pre-configured network stacks including automatic TLS certificates (both local and Let's Encrypt).
Overview of Apache DBD modules
mainThe
dbd-modulespackage provides two Apache 2.4 modules that allow the web server to interact with SQL databases using the Database Driver (DBD) interface:mod_log_dbd: Enables logging of web requests directly to an SQL database.mod_vhost_dbd: Allows overriding the document root directory based on data retrieved from an SQL database.
These modules are distributed as Win64 binaries built with Visual Studio 2026 (VS18).
Overview of Open Server Panel Core Stack and Tools
mainOpen Server Panel provides a comprehensive suite of development tools including web servers, databases, runtimes, and utilities. Key components include:
Web Servers & Databases
- Web Servers: Apache (with 12+ modules), Caddy (with 142+ modules), and Nginx (with 19+ modules).
- Databases: MySQL, MariaDB, MongoDB (includes MongoShell + MongoTools), and PostgreSQL.
Runtimes & Backend Services
- PHP: Includes 115+ extensions.
- Node.js: Managed via NVM.
- Go: Native runtime environment.
- BaaS: PocketBase.
- Message Brokers: RabbitMQ (with ErlangOTP).
- Caching: Redis and Memcached.
Utilities & Infrastructure
- Email Testing: Mailpit and SMTP4dev.
- Media Processing: FFMpeg, ImageMagick, Ghostscript, and Libwebp.
- File Servers: SFTPGo (supporting SFTP, FTP, and WebDAV).
- Security: Vault and
ageencryption. - DNS: Bind and Unbound.
Overview of DBD Modules for Apache 2.4
mainThe
dbd-modulespackage provides two Apache modules that allow Apache 2.4 to interact with databases using the Database Driver (DBD) interface on Windows (Win64 VS18).- mod_log_dbd: Enables logging of web requests directly to an SQL database.
- mod_vhost_dbd: Allows overriding the document root directory based on data from an SQL database.
How mod_maxminddb performs IP lookups
mainBy default,mod_maxminddbuses the client IP address for lookups. If your server is behind a proxy and you need to look up the IP address specified in a request header (likeX-Forwarded-For), you should usemod_remoteipto correctly set the client IP address beforemod_maxminddbprocesses the request.Available Software Stack in Open Server Panel
mainOpen Server Panel includes a comprehensive suite of web servers, databases, runtimes, and utilities:
Web Servers
- Apache (+12 modules)
- Caddy (+142 modules)
- Nginx (+19 modules)
Databases & Caching
- MySQL, MariaDB, PostgreSQL, MongoDB (includes MongoShell + MongoTools)
- Redis, Memcached
Runtimes & Backend
- PHP (+115 extensions)
- Node.js (via NVM)
- Go
- PocketBase (Backend as a Service)
Messaging & Networking
- RabbitMQ (+ ErlangOTP)
- DNS Servers: Bind, Unbound
- SFTPGo (SFTP/FTP/WebDAV)
Media & Security
- Media: FFMpeg, ImageMagick, Ghostscript, Libwebp
- Security: Vault, age-encryption
- Mail Testing: Mailpit, SMTP4dev
Query GeoIPv6.dat with IPv4 mapped addresses
mainTheGeoIPv6.datdatabase supports querying using IPv4 mapped IPv6 addresses. This allows you to look up geographic information for IPv4 addresses by representing them in the::ffff:x.x.x.xformat.Install mod_watch for Apache 2.4
mainTo install the
mod_watchmodule in an Apache 2.4 Win64 environment, follow these steps:- Copy the
mod_watch.sofile into your Apachemodulesfolder. - Create a directory named
watchwithin your Apache installation directory (e.g.,c:/apache24/watch). - Load the module in your
httpd.conffile using theLoadModuledirective.
LoadModule watch_module modules/mod_watch.so- Copy the
Install mod_maxminddb for Apache 2.4.x
mainTo install the
mod_maxminddbmodule, follow these three steps:- Install Prerequisites: Ensure the Visual C++ 2022 x64 Redistributable Package is installed on your system. You can download it from:
https://aka.ms/vs/17/release/VC_redist.x64.exe. - Copy the Module: Copy
mod_maxminddb.soto your Apache modules directory (e.g.,.../Apache24/modules/mod_maxminddb.so). - Copy the Database: Copy
GeoLite2-Country.mmdbto your Apache extra configuration directory (e.g.,.../Apache24/conf/extra/GeoLite2-Country.mmdb).
Note: This build is specifically for Apache 2.4.x x64 only. Modules built on Visual C++ 2022 do not run on Windows XP or Windows Server 2003.
# 1. Install Visual C++ 2022 x64 Redistributable # 2. Copy module: cp mod_maxminddb.so .../Apache24/modules/ # 3. Copy database: cp GeoLite2-Country.mmdb .../Apache24/conf/extra/- Install Prerequisites: Ensure the Visual C++ 2022 x64 Redistributable Package is installed on your system. You can download it from:
Configure mod_vhost_dbd for dynamic document roots
mainTo use
mod_vhost_dbdto override document root directories using an SQL database, follow the official configuration instructions provided by the project maintainers at the SourceForge wiki:Configure mod_log_dbd for SQL request logging
mainTo use
mod_log_dbdto log web requests to an SQL database, follow the official configuration instructions provided by the project maintainers at the SourceForge wiki:http://sourceforge.net/p/dbd-modules/wiki/mod_log_dbd/
Critical Requirement: In your Apache configuration,
mod_log_dbdmust be loaded aftermod_rewrite.Install mod_xsendfile for Apache
mainTo install the
mod_xsendfilemodule in your Apache environment, follow these two steps:- Copy the binary: Move the
mod_xsendfile.sofile into your Apachemodulesfolder. - Enable the module: Add the
LoadModuledirective to yourhttpd.conffile to instruct Apache to load the module at startup.
# Add this to your httpd.conf LoadModule xsendfile_module modules/mod_xsendfile.so- Copy the binary: Move the