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:
Setup Guide
Getting started with PortLocal is as simple as extracting a file. No system-level installation or administrator privileges are required.
System Requirements
OS: Windows 10/11 or modern Linux (Ubuntu 24.04+, Fedora 43+, etc.)
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).
Preparation (Linux Only)
Right-click the AppImage or executable within the folder, go to Properties > Permissions, and check "Allow executing file as program".
Alternatively, you can do this via terminal:
chmod +x PortLocal.AppImageLaunch
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.
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:
Pro Tip: Project Hosting
Your project files should be placed in thewww directory (or the folder defined as DocumentRoot in your Apache config). You can access your files via localhost:[port].
Troubleshooting
MariaDB Configuration Permissions Linux
If MariaDB does not start, ensure the configuration files are not world-writable. MariaDB may ignore configuration files with insecure permissions (such as 777). Using 644 or 640 ensures the configuration is loaded correctly.
Recommended:
More restrictive:
phpMyAdmin Configuration Permissions Linux
If phpMyAdmin fails to load or displays the message Wrong permissions on configuration file, should not be world writable!, ensure the config.inc.php files are not world-writable. Using 644 or 640 provides secure permissions while allowing phpMyAdmin to load the configuration correctly.