8000 GitHub - rtCamp/Frappe-Manager: A CLI tool based on Docker Compose to easily manage Frappe based projects.
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

rtCamp/Frappe-Manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ Frappe Manager

Python 3.11+ GHCR License: MIT PyPI version

Simplify Your Frappe Development & Deployment Workflow

A powerful CLI tool that streamlines the entire lifecycle of Frappe applications using Docker - from development to deployment.

Quick Start β€’ Documentation β€’ Examples β€’ Support

Frappe-Manager-Create-Site.svg

✨ Features

πŸ”₯ Easy Setup

β€’ Get a new Frappe environment running in minutes
β€’ Zero configuration needed

🐳 Docker-Based

β€’ Consistent environments across all platforms
β€’ Isolated development environments

🌐 Multi-Bench Support

β€’ Manage multiple Frappe benches from one server

πŸ‘¨β€πŸ’» Development Tools

β€’ VSCode integration with debugger support
β€’ Automatic environment switching between dev/prod

πŸ”’ SSL Management

β€’ Built-in Let's Encrypt integration
β€’ Automatic certificate renewal

πŸ› οΈ Admin Tools

β€’ Mailpit for email testing
β€’ Redis Queue Dashboard
β€’ Adminer for db management

πŸ› οΈ Requirements

  • Python 3.11 or higher
  • Docker
  • VSCode (optional, for development features)

πŸš€ Quick Start

# 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

πŸ“š Examples

Development Setup

# Create a dev environment with ERPNext
fm create devsite --apps erpnext:version-15 --environment dev

# Start coding (in VSCode)
fm code devsite --debugger

Production Setup

# 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

Daily Operations

# 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

πŸ“– Documentation

Visit our Wiki for:

  • πŸ“‹ Detailed guides
  • βš™οΈ Configuration options
  • πŸ’‘ Best practices
  • ❓ Troubleshooting

🀝 Support

πŸ‘ Credits

Based on official Frappe Docker images.

πŸ“„ License

MIT License - see LICENSE file for details

About

A CLI tool based on Docker Compose to easily manage Frappe based projects.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 
0