Skip to content

Home

Jump to bottom
nunoluciano edited this page Apr 11, 2026 · 8 revisions

AMP Manager

Desktop app for local development. Docker-based stack with a click-and-run GUI. No terminal required.

Features

AMP Manager provides a unified interface for:

  • Local domain management with automatic SSL certificates
  • Docker container monitoring and control
  • Encrypted credentials and notes storage
  • Visual workflow automation
  • Tunnel services integration (share local projects)

Activity Timeline

Docker Management

First Run Setup

  1. Install Docker Desktop - Download and install Docker Desktop
  2. Install AMP Manager - Download a release or clone to your drive

IMPORTANT: After running npm run build:app, you MUST run post-build.bat to apply the UAC manifest. Without this, the app runs without admin privileges and cannot install SSL certificates or modify the hosts file.

Run Docker and Amp Manager

  1. Start Docker Desktop - Ensure Docker is running (check system tray icon)
  2. Initialize containers - Open a terminal in the AMP Manager folder and run: 
    docker compose up -d
  3. Launch AMP Manager - The dashboard will show all systems as "Healthy"

Note: Docker must be running whenever you use AMP Manager. The Dashboard's System Checks section displays the current status. You can also use AMP Manager to launch and control Docker.

Tech Stack

Layer Technology
Frontend React 19, TypeScript, Vite, Tailwind CSS, DaisyUI
Backend Neutralino.js 6.5, Windows Batch (amp-tasks.bat)
Storage JSON Files (users/ folder), Web Crypto for encryption
Containers Docker Compose (Angie, PHP, MariaDB)

Documentation

Document Description
Core Concepts How AMP works
For Students Step-by-step for beginners
For Developers Quick start for devs
Architecture System design
Amp Tasks Reference Batch commands
API Reference AMPBridge API
Component Reference UI components
User Interface UI tech stack
Security Security model
Workflows Deployment guides
Tunneling Tunnel services
Contributing Developer guide
Troubleshooting Common issues
Glossary Terms explained

Quick Start

Prerequisites

  • Docker Desktop installed and running
  • Windows 10/11

Installation

  1. Clone or download AMP Manager
  2. Open terminal in the project folder
  3. Run: docker compose up -d
  4. Run: npm run build:app
  5. Run: post-build.bat
  6. Launch amp-manager.exe

Creating Your First Domain

  1. Open AMP Manager
  2. Click "Add Domain"
  3. Enter domain name (e.g., mysite)
  4. Click Create

Your domain is now available at http://mysite.local with automatic SSL!

Key Concepts

Domains

Local domains with automatic SSL. Each domain gets:

  • Auto-created folder in www/
  • SSL certificate via mkcert
  • Angie configuration
  • Hosts file entry

Containers

Docker containers managed by AMP:

  • Angie - Web server
  • PHP - PHP runtime
  • MariaDB - Database

Encryption

Sensitive data (credentials, notes, settings, workflows, site configs) is encrypted using AES-256-GCM with keys derived from your password.

Support

License

MIT License - See LICENSE file for details.

Clone this wiki locally