FlyEnv
# FlyEnv <div align="center"> <img src="https://raw.githubusercontent.com/xpf0000/FlyEnv/master/build/256x256.png" width="180" alt="FlyEnv Logo" /> <h1>Install, Switch, and Run Local Dev Stacks Natively</h1> <p> <strong>FlyEnv is a desktop app for managing local development environments on Windows, macOS, and Linux.</strong><br> Install and run PHP, Node.js, Python, Java, .NET, Flutter, web servers, databases, queues, AI tools, SSL, local domains, reverse proxies, and cron jobs from one UI.<br> Use native binaries, switch versions per project, and keep your system PATH clean—<strong>no Docker required</strong>. </p> *Best for web, backend, mobile, and full-stack developers who want local services without container overhead.* <p> <a href="https://github.com/xpf0000/FlyEnv/releases"><img src="https://img.shields.io/github/release/xpf0000/FlyEnv.svg" alt="GitHub release"></a> <a href="https://github.com/xpf0000/FlyEnv/releases"><img src="https://img.shields.io/github/downloads/xpf0000/FlyEnv/total.svg" alt="Total Downloads"></a> <a href="https://ko-fi.com/R5R2OJXTM"><img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="ko-fi"></a> </p> </div> ## What Can You Do With FlyEnv? * **Install runtimes on demand:** PHP, Node.js, Python, Java, .NET, Flutter, Go, Rust, Ruby, Bun, Deno, and more. * **Run local services:** Nginx, Apache, Caddy, MySQL, PostgreSQL, MongoDB, Redis, RabbitMQ, Elasticsearch, Minio/RustFS, and other common development dependencies. * **Manage projects:** Switch runtime versions per project, define start/stop commands, expose projects through local domains, reverse proxies, HTTPS, and Cloudflare Tunnel. * **Handle daily dev tasks:** Edit configs and logs, inspect ports, schedule cron jobs, manage Git, generate certificates, compare diffs, test WebSocket/SSE, and work with JWTs. ## Is FlyEnv For You? | Choose FlyEnv if you... | It may not be the best fit if you... | | :--- | :--- | | Want XAMPP/MAMP/Herd-style convenience across many stacks | Need exact Docker Compose or Kubernetes parity with production | | Work with multiple runtime versions across projects | Only use one runtime and are happy with your system package manager | | Want databases, queues, search, storage, and AI tools without maintaining containers | Prefer to manage every service manually from the terminal | | Build local web, backend, mobile, or full-stack projects on Windows, macOS, or Linux | Need a hosted platform or production deployment system | --- ## 🚀 How FlyEnv Fits Most local dev tools are either too heavy for everyday work (Docker Desktop) or too low-level for full-stack projects (NVM/Homebrew/package managers). FlyEnv sits in the middle: a native desktop manager for the tools and services you actually run while building software. | Capability | FlyEnv | Docker Desktop | XAMPP/MAMP | | :--- | :--- | :--- | :--- | | **How services run** | Native processes managed from a desktop UI | Containers managed through images and compose files | Native bundled web stack | | **Scope** | Runtimes, databases, web servers, project services, and developer tools | Any containerized service or application | Primarily PHP/web-server/database stacks | | **Project versions** | Built-in project runtime workflows | Defined in container configuration | Usually global or manual | | **Best suited for** | Native local development across many stacks | Reproducible container-based environments | Traditional local PHP development | ### Core Benefits * **On-Demand Modules:** Install only the runtimes and local services your projects need. * **Native Processes:** Run installed services directly on your operating system rather than inside Docker containers. * **Project Workflows:** Switch Node/PHP environments by project and define project service commands, ports, domains, and HTTPS. * **Full-Stack Coverage:** Enable databases, queues, search engines, object storage, AI tools, and scheduled tasks from one app. * **Multilingual UI:** Use FlyEnv in 30+ languages. --- ## 🎯 Tailored for Your Workflow <details open> <summary><strong>🐘 For PHP & Laravel Developers</strong></summary> > The best **Windows alternative to Laravel Herd**. > * Switch between PHP 5.6, 7.4, 8.x instantly. > * Run Nginx/Apache, MySQL, Redis, and Mailpit out of the box. > * Native `composer` performance (no file-sharing lag). > * **[Download for Windows](#windows-recommended)** </details> <details> <summary><strong>🟢 For Node.js & Frontend Developers</strong></summary> > Stop fighting with NVM. > * Define Node versions per project (automatically detects `package.json`). > * Instant access to Elasticsearch, PostgreSQL, or RabbitMQ without `docker-compose`. > * Supports Bun, Deno, and PM2 management. </details> <details> <summary><strong>☕ For Java, Python, .NET, Flutter & Go Developers</strong></summary> > * Manage multiple JDKs (Maven/Gradle/SDKMAN), .NET SDKs, Flutter SDKs, and Python environments effortlessly. > * Run Flutter diagnostics, Android device checks, and project build commands from one place. > * Keep your global system PATH clean and organized. </details> --- ## 📦 Supported Modules (On-Demand) FlyEnv allows you to install **only what you need** from a vast library of supported software: * **AI Integration**: Hermes Agent, [OpenClaw], [n8n], [Ollama], CliProxyAPI * **Containers**: Podman. * **Network Tunnel**: Cloudflared, Cloudflare Tunnel. * **Web Servers**: FrankenPHP, [Apache], [Nginx], Caddy, Tomcat. * **Databases**: [MySQL], [MariaDB], [PostgreSQL], [MongoDB], Qdrant. * **Email Server**: Mailpit. * **Programming Languages & Runtime**: .NET, Flutter, PHP (Composer, [PHP-CLI], [PHP-FPM], [RoadRunner], [Swoole Cli]), Go, [Node.js], [Python], Java (Maven, Gradle, SDKMAN), Erlang, Ruby, Rust (Rustup), Bun, Deno, Zig. * **Cache & Message Queue**: [Redis], Memcached, RabbitMQ. * **Service Governance**: Consul, Etcd, R-Nacos * **Search Engine**: Elasticsearch, Meilisearch, Typesense, ZincSearch * **Object Storage**: RustFS, Minio. * **Automation & Scheduling**: Cron Jobs. * **Utilities**: Git, MkCert, DNS Server, FTP Server, Static HTTP Server. * **Custom modules**: Users can add modules on their own, whether as services or commonly used commands. FlyEnv's custom module system ensures that user modules function just like system modules, delivering a seamless user experience. > *All modules support multi-version co-existence.* [OpenClaw]: https://youtu.be/j7_B-VzIyEU [Ollama]: https://youtu.be/yPk9HQJRvb8 [n8n]: https://youtu.be/YnA1B3qmDJU [Apache]: https://youtu.be/t7nKL45FdVk [Nginx]: https://youtu.be/zfdNZFRt3k4 [MySQL]: https://youtu.be/uWWHAqxhVyk [PHP-FPM]: https://youtu.be/OYP1IOoJOtI [Python]: https://youtu.be/dhy0nJYsfQQ [Redis]: https://youtu.be/u9xjPN-VWT4 [PHP-CLI]: https://youtu.be/5NqSag8c4YY [RoadRunner]: https://youtu.be/5NqSag8c4YY [Swoole CLI]: https://youtu.be/5NqSag8c4YY [Node.js]: https://youtu.be/Pt_I3NDciZw [MariaDB]: https://youtu.be/mvmbRi6KsgI [PostgreSQL]: https://youtu.be/5gW3WHh8_Jw [MongoDB]: https://youtu.be/wPjgwVeA6lw [Nodejs]: https://youtu.be/Pt_I3NDciZw --- ## 🛠 Developer-Friendly Tools * **Local Domains & SSL:** Create local sites (`myapp.test`) with custom domains and **one-click HTTPS** backed by MkCert/local certificates. * **Project Services & Reverse Proxy:** Define custom start/stop commands, ports, reverse proxy rules, and HTTPS for projects in any language. * **Cron Jobs:** Schedule global or site-scoped commands with native crontab and Windows Task Scheduler integration. * **Config & Logs:** Edit `php.ini` or `my.cnf` directly in FlyEnv. View real-time error logs with highlighting. * **Port Management:** Visualize which apps are using which ports and kill processes instantly. * **Toolbox:** Compare text diffs, encode/decode JWTs, calculate cron schedules, and test WebSocket/SSE connections. [Watch Video Demo](https://flyenv.com/#tools-modules)  --- ## 📥 Installation ### Windows (Recommended) Finally, a fast, native environment for Windows developers. * **Installer:** [FlyEnv-Setup-4.15.3.exe](https://github.com/xpf0000/FlyEnv/releases/download/v4.15.3/FlyEnv-Setup-4.15.3.exe) * **Portable:** [FlyEnv-Portable-4.15.3.exe](https://github.com/xpf0000/FlyEnv/releases/download/v4.15.3/FlyEnv-Portable-4.15.3.exe) ### macOS * **Homebrew:** `brew install flyenv` * **DMG (Intel):** [FlyEnv-4.15.3.dmg](https://github.com/xpf0000/FlyEnv/releases/download/v4.15.3/FlyEnv-4.15.3.dmg) * **DMG (Apple Silicon):** [FlyEnv-4.15.3-arm64.dmg](https://github.com/xpf0000/FlyEnv/releases/download/v4.15.3/FlyEnv-4.15.3-arm64.dmg) ### Linux Supports Debian/Ubuntu (.deb) and RedHat/CentOS (.rpm). #### Debian / Ubuntu - **x86_64**: [FlyEnv-4.15.3-x64.deb](https://github.com/xpf0000/FlyEnv/releases/download/v4.15.3/FlyEnv-4.15.3-x64.deb) - **ARM64**: [FlyEnv-4.15.3-arm64.deb](https://github.com/xpf0000/FlyEnv/releases/download/v4.15.3/FlyEnv-4.15.3-arm64.deb) #### Red Hat / Fedora / SUSE / CentOS - **x86_64**: [FlyEnv-4.15.3-x64.rpm](https://github.com/xpf0000/FlyEnv/releases/download/v4.15.3/FlyEnv-4.15.3-x64.rpm) - **ARM64**: [FlyEnv-4.15.3-arm64.rpm](https://github.com/xpf0000/FlyEnv/releases/download/v4.15.3/FlyEnv-4.15.3-arm64.rpm) --- **📦 Build & Transparency** All FlyEnv installation packages are now built using **[GitHub Actions](https://github.com/xpf0000/FlyEnv/actions)**. You can verify the build process and download the artifacts directly from the following links: * **Global Build History:** [GitHub Actions](https://github.com/xpf0000/FlyEnv/actions) --- ## 📸 Interface Preview <table> <thead> <tr> <th width="50%" align="center">Service Management</th> <th width="50%" align="center">Version Switching</th> </tr> </thead> <tbody> <tr> <td align="center"><a target="_blank" rel="noopener noreferrer" href="./screen1.jpeg"><img src="./screen1.jpeg" alt="Manage Services" width="100%" style="max-width: 100%;"></a></td> <td align="center"><a target="_blank" rel="noopener noreferrer" href="./screen2.jpeg"><img src="./screen2.jpeg" alt="Version Switching" width="100%" style="max-width: 100%;"></a></td> </tr> <tr> <td align="center"><strong>Manage Nginx/MySQL/Redis in one place</strong></td> <td align="center"><strong>Switch PHP/Node versions per project</strong></td> </tr> </tbody> </table> --- ## Development & Contribution We welcome contributions! FlyEnv is built with Node.js & web technologies (Electron/Vue). ```bash git clone [email protected]:xpf0000/FlyEnv.git cd FlyEnv yarn install yarn run dev ``` Check out our [Development Guide](./DEV.md) to get started. ## Community & Support * **Technical Deep Dive:** [Architecture Analysis](https://deepwiki.com/xpf0000/FlyEnv) * **Facebook Group:**[Facebook Group](https://www.facebook.com/groups/908637655411162) * **Discord:** [Join Community](https://discord.gg/u5SuMGxjPE) * **Discussions:** [GitHub Discussions](https://github.com/xpf0000/FlyEnv/discussions) * **Website:** [flyenv.com](https://www.flyenv.com) **License:** Open-source under the [BSD 3-Clause License](https://github.com/xpf0000/FlyEnv/blob/master/LICENSE).