These installations need to be done just once so you can skip this section if you have the software already installed.

Node.js

Install Node.js so you can work with npm, Node package manager. Version 6 or 8+ is required. Node 7 is not supported.

Yeoman & Chisel

Install Yeoman and Chisel globally. In your command line type:

npm install -g yo generator-chisel

If you want to update your existing Chisel installation to the latest version, run:

npm install -g generator-chisel

Apache, PHP and MySQL

If you want to develop WordPress projects, you need to install Apache, PHP and MySQL. The easiest option is to use development environments like MAMP or XAMPP. If using MAMP, check Allow network access to MySQL.

If you are on macOS, we recommend to install necessary packages with Homebrew according the following guides:

• macOS 10.14 Mojave Apache Setup: Multiple PHP Versions – skip multiple PHP versions installation if you want
• macOS 10.14 Mojave Apache Setup: MySQL, APC & More… – you can skip YAML and Xdebug installation

Known Issues

mysql or mysqlcheck not found

Chisel is using WP-CLI for most WP-related operations. WP-CLI is using mysql and mysqlcheck binaries, so check out if you have mysql and mysqlcheck binaries in your $PATH by running the following commands:

mysql --version
mysqlcheck --version

MySQL 8 authentication method not supported

If you happen to be using MySQL 8 with Chisel, you may encounter an error when trying to setup a project. mysqljs library used by Chisel doesn’t support default authentication method of MySQL 8 yet.

You can verify what method MySQL is using by running:

mysql -u root -p
USE mysql
SELECT host, user, plugin, authentication_string FROM user WHERE user='root';

If the result lists auth_socket, Chisel project setup won’t work. You can update authentication method by running the following commands:

ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY '[enter your password]';
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY ' [enter your password] ';

Alternative, switch to MariaDB or MySQL 5.

Problems with installation?

Submit an issue at GitHub with a label question or write us to the e-mail [email protected]. We are happy to help.