Documentation

Overview

PortLocal is a streamlined, portable environment manager designed to give you instant control over your local web development stack. Whether you're a developer on the go or need a sandboxed environment for testing, PortLocal provides everything you need in a single, zero-installation package.

What's Included?

Your PortLocal download comes as a complete ZIP file pre-configured with the following core technologies, allowing you to start developing immediately:

Apache Server
Apache
Web Server
v2.4.66
PHP Scripting Language
PHP
Scripting
v8.4.6
MariaDB Database
MariaDB
Database
v11.4.10
phpMyAdmin Graphical Tool
phpMyAdmin
DB Admin
v5.2.3

Setup Guide

Getting started with PortLocal is as simple as extracting a file. No system-level installation or administrator privileges are required.

1
Download & Extract

Download the ZIP file for your specific OS. Extract the contents to any folder (e.g., your Desktop, Documents, or a USB drive).

2
Preparation (Linux Only)

Right-click the AppImage or executable within the folder, go to Properties > Permissions, and check "Allow executing file as program".

3
Launch

Double-click the PortLocalexecutable to open the management dashboard. The software will automatically initialize the bundled services.

Managing Services

The Dashboard

The main interface displays the live status of Apache and MariaDB. Use the Start and Stop buttons to toggle services instantly.

Active Status
Dynamic Port Detection

PortLocal doesn't use hardcoded ports. If you change your port in the configuration files, the dashboard will automatically detect and display the new port upon service restart.

Database Access

MariaDB is included in the portable stack. You can manage your databases using the bundled **phpMyAdmin** interface without any additional setup.

  • Click the phpMyAdmin button in the dashboard to open the interface.
  • Default Username: root
  • Default Password: (Empty/None)

Configuration

For advanced users, the configuration files are easily accessible within the application folder hierarchy:

# Apache Config
/path/to/portlocal/bin/apache/conf/httpd.conf
# MariaDB Config
/path/to/portlocal/bin/mysql/my.cnf
Pro Tip: Project Hosting

Your project files should be placed in thebin/www directory (or the folder defined as DocumentRoot in your Apache config). You can access your files via localhost:[port].