A powerful CLI tool that streamlines the entire lifecycle of Frappe applications using Docker - from development to deployment.
Quick Start β’ Documentation β’ Examples β’ Support
β’ Get a new Frappe environment running in minutes β’ Zero configuration needed |
β’ Consistent environments across all platforms β’ Isolated development environments |
β’ Manage multiple Frappe benches from one server |
β’ VSCode integration with debugger support β’ Automatic environment switching between dev/prod |
β’ Built-in Let's Encrypt integration β’ Automatic certificate renewal |
β’ Mailpit for email testing β’ Redis Queue Dashboard β’ Adminer for db management |
- Python 3.11 or higher
- Docker
- VSCode (optional, for development features)
# Install Frappe Manager (stable)
pipx install frappe-manager
# Install Frappe Manager (latest develop)
pipx install git+https://github.com/rtcamp/frappe-manager@develop
# Setup shell completion
fm --install-completion
# Create your first site
fm create mysite
# Create a dev environment with ERPNext
fm create devsite --apps erpnext:version-15 --environment dev
# Start coding (in VSCode)
fm code devsite --debugger
# Create Production Site
fm create example.com --environment prod
# Create production site with SSL using HTTP01 challenge
fm create example.com --environment prod \
--ssl letsencrypt --letsencrypt-preferred-challenge http01 \
--letsencrypt-email admin@example.com
# Create production site with SSL using DNS01 challenge
fm create example.com --environment prod \
--ssl letsencrypt --letsencrypt-preferred-challenge dns01 \
--letsencrypt-email admin@example.com
# Common commands
fm start mysite # Start site
fm stop mysite # Stop site
fm info mysite # View site info
fm logs mysite -f # View logs
fm shell mysite # Access shell
Visit our Wiki for:
- π Detailed guides
- βοΈ Configuration options
- π‘ Best practices
- β Troubleshooting
- π Report issues
- π¬ Discussions
- π Star us on GitHub!
Based on official Frappe Docker images.
MIT License - see LICENSE file for details