Get Started with HiveMQ CE
Follow these steps to get HiveMQ Community Edition running quickly.Download or Pull Image
Choose your preferred method to get HiveMQ CE:
Java 11 or higher is required to run the binary package.
Start HiveMQ CE
Launch the broker:HiveMQ CE starts on port 1883 (MQTT) and 8000 (WebSocket) by default.
What’s Running?
Once started, HiveMQ CE provides:- MQTT Broker on port 1883 (TCP)
- WebSocket Endpoint on port 8000 at
/mqtt - Local file-based persistence for QoS 1/2 messages
- Default configuration allowing all clients
Next Steps
Installation Guide
Detailed installation options for all platforms
Configuration
Configure listeners, security, and MQTT settings
MQTT Protocol
Learn about MQTT features and capabilities
Deployment
Production deployment strategies
Common Issues
Port 1883 already in use
Port 1883 already in use
Another MQTT broker or service is using port 1883.Solution: Stop the other service or configure HiveMQ CE to use a different port in
config.xml.Java version error
Java version error
HiveMQ CE requires Java 11 or higher.Solution: Install JDK 11+ and verify with
java -version.Permission denied
Permission denied
The run script or binary doesn’t have execute permissions.Solution: Run
chmod +x bin/run.sh on Linux/macOS.Resources
- Introduction - Learn about HiveMQ CE features
- MQTT Guides - Client connection examples
- Extensions - Extend HiveMQ with custom logic
- Community Forum - Get help from the community