Bee

Bee is a command line utility for Backdrop CMS. It includes commands that allow developers to interact with Backdrop sites, performing actions like:

• Running cron
• Clearing caches
• Downloading and installing Backdrop
• Downloading, enabling and disabling projects
• Viewing information about a site and/or available projects

See the Release notes and the Changelog for details of changes between versions.

Requirements

Operating System

• Bee will work in most Linux based environments.
• Bee will NOT work natively in Windows but can be used inside Linux based virtual environments such as WSL2.
• Bee requires the mysql and mysqldump executables to be installed for most database operations (i.e. db-export, db-import, db-drop, sql but NOT db-query).

PHP

• Bee is tested and works from 7.4 up to 8.3.

Installation

• Download (or clone) Bee to your computer/server.
  This will create a folder called bee with lots of files inside. Your home directory is a good location for this folder. It is neither required nor recommended to place this folder within the Backdrop web root.

• Make sure bee/bee.php is executable.
  It should be by default, but it doesn't hurt to double-check.

• Make it easy to run bee commands.
  There are two ways to do this:

  1. Put a symlink to bee/bee.php in your $PATH (e.g. sudo ln -s /path/to/bee/bee.php /usr/local/bin/bee)

  2. Make a Bash alias for bee (e.g. add alias bee='/path/to/bee/bee.php' to your .bash_aliases file)

• Test to make sure it works.
  Simply type bee in your terminal and you should see a list of available commands displayed.

More advanced/specialised installation instructions can be found in the wiki.

Extending

Bee can be extended (i.e. custom/additional commands added) by Backdrop contrib modules or by individual users. See API.md for details.

Issues

Bugs and feature requests should be reported in the issue queue: https://github.com/backdrop-contrib/bee/issues.

Current Maintainers

• Martin Price - System Horizons
• Collaboration and co-maintainers welcome!

Credits

• Originally written for Backdrop CMS by Geoff St. Pierre
  (originally called 'Backdrop Console (a.k.a. b)').
• Grateful thanks goes to previous maintainers and collaborators who have helped bring Bee to where it is today. See the list of contributors for details. Contributions by "BWpanda" were made by Peter Anderson and not the user who is currently associated with the "BWpanda" user name.
• Inspired by Drush.
• Bee icon by AomAm from the Noun Project.

License

This project is GPL v2 software. See the LICENSE.txt file in this directory for complete text.