Getting Started
Welcome to FluidNC GUI! This guide will help you create your first FluidNC configuration quickly and easily.
What You'll Learn
By the end of this guide, you'll know how to:
- Access and navigate the FluidNC GUI
- Choose between Wizard and Expert modes
- Configure basic machine settings
- Set up motors and pins
- Export your configuration
- Upload to your FluidNC board
Prerequisites
Before you start, make sure you have:
- A FluidNC-compatible board (ESP32-based)
- Basic knowledge of your CNC machine (axes, motor types, etc.)
- Pin information for your board or breakout board
- Web browser (Chrome, Firefox, Safari, or Edge)
Two Ways to Configure
FluidNC GUI offers two main approaches:
🧙♂️ Wizard Mode (Recommended for Beginners)
- Step-by-step guided process
- Built-in validation and conflict detection
- Perfect for standard machine setups
- Goal: Complete config in under 10 minutes
🔧 Expert Mode (For Advanced Users)
- Direct access to all configuration options
- Tree-based editor with real-time validation
- Supports custom and experimental features
- Import/export existing configurations
Quick Start Path
For the fastest route to a working configuration:
- Installation - Access the GUI
- First Configuration - Create a basic config in under 10 minutes
- Understanding FluidNC - Learn the concepts
Need Help?
- Check our Troubleshooting section
- Browse Recipes for example configurations
- Ask questions in the FluidNC Community
Ready to start? Let's go to Installation! 🚀