Skip to content

README_EN.md

Latest commit

 

History

History
178 lines (117 loc) · 5.51 KB

README_EN.md

File metadata and controls

178 lines (117 loc) · 5.51 KB

AstroWAMP Portable Node.js Application

Language / Dil: 🇹🇷 Türkçe | 🇬🇧 English

Download

https://drive.google.com/file/d/1NIlF4qbY1sI4bFeWArmao9pla2ZPQsli/view?usp=sharing

Proje Demo Videosu

🚀 Standalone Executable

This is the portable version of the AstroWAMP Node.js application. It runs as a single .exe file with Node.js runtime included.

🎯 Full-Featured Development Environment

With AstroWAMP, you can run the following services on a single platform:

  • ⚡ Apache Web Server - Powerful and flexible web server
  • 🐘 PHP - The most popular server-side programming language
  • 🗄️ MySQL Database - Reliable and fast database management
  • 🟢 Node.js - Modern JavaScript runtime environment
  • 📊 phpMyAdmin - Easy-to-use database management interface

🚀 Standalone Executable

This is the portable version of the AstroWAMP Node.js application. It runs as a single .exe file with Node.js runtime included.

image image image image image image image image image

📦 Contents

portable/
├── AstroWAMP-NodeApp.exe    # Main executable (Node.js runtime included)
├── data/                     # Data storage (auto-created)
├── uploads/                  # File uploads (auto-created)
└── logs/                     # Application logs (auto-created)

⚡ Quick Start

Windows

  1. Double-click the AstroWAMP-NodeApp.exe file
  2. Open http://localhost:5000 in your browser
  3. Start using it!

🔧 Configuration

Changing Port

Use an environment variable to change the port number:

set PORT=3000
AstroWAMP-NodeApp.exe

Or via command line:

AstroWAMP-NodeApp.exe --port 3000

Running from Different Locations

Copy the entire portable/ folder anywhere you want:

  • Different drive (C:, D:, E:, etc.)
  • USB drive
  • Network drive
  • Cloud storage folder

The executable always runs within its containing folder.

🌐 API Endpoints

Once the application is running, you can access these endpoints:

  • Home Page: http://localhost:5000/
  • Status API: http://localhost:5000/api/status
  • System Info: http://localhost:5000/api/info
  • Portable Paths: http://localhost:5000/api/paths
  • Health Check: http://localhost:5000/api/health

📝 Features

✅ Single File: Node.js runtime included, no additional installation required ✅ Portable: Runs from any location ✅ Auto Folders: Automatically creates required folders ✅ Logging: All operations are automatically logged ✅ Modern UI: Interface compatible with AstroWAMP design ✅ RESTful API: Full-featured API endpoints

🗂️ Data Management

Data Folder

You can save any data to the data/ folder:

// Example usage in code
const filePath = path.join(DATA_DIR, 'mydata.json');
fs.writeFileSync(filePath, JSON.stringify(data));

Uploads Folder

The uploads/ folder is used for file uploads.

Logs Folder

All operations are logged in logs/app-YYYY-MM-DD.log format.

🔒 Security

  • Port is only accessible from localhost by default
  • You may need to configure firewall settings for external access
  • Implement additional security measures in production environments

🐛 Troubleshooting

"Port Already in Use" Error

# Use a different port
set PORT=3001
AstroWAMP-NodeApp.exe

Folders Not Being Created

  • Ensure you have write permissions
  • Run as administrator (if necessary)

Executable Not Running

  • Check Windows Defender / Antivirus
  • Add the .exe file to the "allow" list

📊 System Requirements

  • OS: Windows 7/8/10/11 (x64)
  • RAM: At least 256 MB
  • Disk: At least 50 MB free space
  • Network: Optional (not required for localhost only)

🔄 Updating

When a new version is released:

  1. Backup existing data/, uploads/, logs/ folders
  2. Replace the AstroWAMP-NodeApp.exe file with the new version
  3. Run the executable

Your data will be preserved!

📚 More Information

Apache (If httpd won't start, don't forget to install) -> VC_redist.x64.exe For the main project: AstroWAMP GitHub

📄 License

MIT License - You can freely use, modify, and distribute.

Made with ❤️ for AstroWAMP | Portable Development Environment