📘 LocalDevine User Guide

Complete user manual for LocalDevine | คู่มือการใช้งาน LocalDevine ฉบับสมบูรณ์

🚀 Getting Started

First Steps

1. Open LocalDevine - Double-click LocalDevine.exe. Recommended: Right-click → Run as Administrator
2. Start Services - Click Start on Apache and MariaDB. Wait for green "Running" status
3. Test - Open browser and go to http://localhost

Dashboard Overview

• Service Cards - Apache, PHP, MariaDB status and controls
• Quick Actions - Open www folder, Config, Terminal, Database
• Console Logs - Real-time service logs
• Navigation - Projects, Virtual Hosts, SSL, Settings, etc.

⚙️ Managing Services

Apache Web Server

Action	Steps
Start	Click Start on Apache card → Wait for Running status
Stop	Click Stop on Apache card → Wait for Stopped status
Restart	Click Stop then Start (required after config changes)

MariaDB Database

Default Credentials: Username: root | Password: root

PHP

PHP runs automatically with Apache - no separate start needed.

📁 Creating Projects

Create New Project

1. Go to Projects menu
2. Click Create New Project
3. Fill in: Project Name, Template (PHP/HTML), Create Database option
4. Click Create

Available Templates

Template	Description
PHP Basic	PHP project with index.php
HTML Basic	Basic HTML/CSS/JS project

Access Your Project

• URL: http://localhost/project-name
• Folder: C:\LocalDevine\www\project-name

🌐 Virtual Hosts

Virtual Hosts let you use custom local domains instead of localhost/project

Create Virtual Host

1. Run LocalDevine as Administrator (required!)
2. Go to Virtual Hosts menu
3. Click Add Virtual Host
4. Fill in: Name, Domain (e.g., mysite.local), Path
5. Click Add → Restart Apache

Recommended Domains

Domain	Notes
*.local	✅ Recommended
*.test	✅ Recommended
*.dev	❌ Not recommended (used by Google)

🗄️ Database Management

Access Adminer

1. Click 🗄️ Database button on dashboard
2. Login with: Server 127.0.0.1, Username root, Password root

Import/Export

Action	Steps
Import	Select database → Click Import → Choose .sql file → Execute
Export	Select database → Click Export → Choose SQL format → Export

🔐 SSL Certificates

Generate self-signed SSL certificates for HTTPS development.

Generate Certificate

1. Go to SSL menu
2. Click Generate Certificate
3. Enter domain name (e.g., mysite.local)
4. Click Generate

Trust Certificate

1. Click Trust button next to the certificate
2. Windows will ask for confirmation
3. Certificate is added to trusted root

🌍 Environment Variables

Manage .env files for your projects.

1. Go to Environment menu
2. Select a project
3. View and edit environment variables
4. Click Save

📝 Hosts File Editor

Edit Windows hosts file without opening Notepad.

1. Go to Hosts File menu
2. Click Add Entry
3. Enter IP Address and Hostname
4. Click Add

⚠️ Note: Requires Administrator privileges

📂 Quick Access

Easy access to important folders from Settings.

Button	Location	Purpose
⚙️ Bin Folder	Program Files\LocalDevine\...\bin	Apache, PHP, MariaDB executables
📄 Config Folder	C:\LocalDevine\config	php.ini, httpd.conf
🌐 WWW Folder	C:\LocalDevine\www	Your projects
📋 Logs Folder	%APPDATA%\LocalDevine\logs	Application logs

⚙️ Settings

Port Configuration

Service	Default Port	How to Change
Apache	80	Settings → Apache Port
MariaDB	3306	Settings → MariaDB Port

Other Settings

• Auto-start Services - Start services automatically when app opens
• Theme - Toggle between Light and Dark theme

🔧 Troubleshooting

Apache Won't Start

Possible causes: Port 80 in use, config errors

# Check what's using port 80
netstat -ano | findstr :80

MariaDB Won't Start

Solution: Delete C:\LocalDevine\data\mariadb\*.pid files and try again

Virtual Host Not Working

• Run LocalDevine as Administrator
• Check domain is in hosts file
• Restart Apache after adding Virtual Host

Can't Login to Adminer

Make sure MariaDB is running. Use: Server 127.0.0.1, Username root, Password root

---

Need help? Report an issue on GitHub