Quick Tip: If you only see some question marks…

… this could be a PHP Unicode setting.
Try to turn off detect_unicode in your php.ini.
You can simply try this by running n98-magerun like this:

If question marks are gone the problem is solved.

The PHP issue also affects some popular tools like composer or phpunit.
Settings can be persisted in php.ini or you can create an alias on your system.

Magerun Tips

Add your own check to sys:check command

For two days we published the new n98-magerun version 1.90.0 with a refactored sys:check command.
The command is now modular and all checks are organized in sub-classes.
It’s now possible to add own checks to the command. The blog post shows you how easy it is.

Registration of Check Classes

If you investigate the distribution config of n98-magerun you can see a bunch of new configuration for the command.
The new config node is “checks” which contains the class names of all checks. All classes are organized in check groups.

Check Class Config


Released n98-magerun version 1.90.0

Today we are proud to release a new stable n98-magerun version.
The new release contains some very nifty new features and enhancemnts which make
your live as Magento Developer a lot of easier.


sys:check command got a modular structure

We refactored the sys:check command. All checks were moved into own sub-classes which are
registrated over dist config.
With the new system you are able to add new checks over your config. We will write an additional
blog post addressing the new big feature.



Released version 1.89

After the release of the new Magento CE 1.9 we updated n98-magerun to support the installation of the new version.
The release 1.89 contains also some bugfixes and smaller enhancements.


  • #320 Fixing minor grammatical error (by Chris Jones)
  • #326 Encryption key parameter in install command (by Kristof Ringleff)
  • #327 Uninstall from specified folder (by Kristof Ringleff)
  • #328 added Magento CE install option (by Hans Kuijpers)
  • #329 Added Magento CE to test script (by Hans Kuijpers)
  • #331 Keep dataflow profiles when stripping temp tables
  • Changed download URLs to
  • Updated 3rd party dependencies

Looking for Magento Developers at netz98 in Mainz or Würzburg

While my colleagues and me are continuously improving the magerun tool for the Magento community, I need to get the word out: I am always looking for talented and experienced Magento developers to work with us at netz98 in Mainz or Würzburg, Germany.

Be it permanent positions, freelancers or even agencies looking to become part of netz98, one of the top Magento Gold Partners – just contact me or my colleagues at netz98 for more information: I will be at the Meet Magento in Leipzig.


Released version 1.88.0

After some weeks of testing we deployed version 1.88.0 of n98-magerun.
The new release contains three new commands and some bugfixes and (special) enhancements.

New Translation Commands

Alexander Menk created a the new dev:translate:export command.
If you have translated content in core_translate table (generated by Magento Inline Translation feature)
you can now export the content with ease.


This exports the data of locale en_US to file translation_en.csv.
If you have different translations for a locale in a specific store you can add the --store option to
limit the selection.


Released version 1.87.0

It’s the third release in 2014. The new release contains two new commands, some typo fixes and complete reworked bash completion script.

Bash Completion reworked

A often requested feature was a working bash completion script.
Thanks to Allard Hoeve from Byte Internet who created a new whole new bash completion
The new script can be found here:

  • #294, #300, #301 New bash completion script (by Allard Hoeve)

n98-magerun Capistrano plugin

If you use n98-magerun and Capistrano you should check out the ruby gem “capistrano-magerun” created by Robert Coleman.

It’s easy installable by:

For more detailed informations about the correct usage you should look on the github project page.


Released version 1.86.0

Release 1.86.0 is ready. The new version contains some bugfixes and a new command.

New db:maintain:check-tables Command

We added a new command to maintain the database. The command checks the MySQL Database for errors.
The result table can be returned as XML, CSV and JSON with format option.
If no option is specified the command shows a progressbar and a ASCII table with all results.

The MySQL Check support multiple check types:

  • FAST

The default check type is “MEDIUM” which means:
To see a complete description of all types call the command with --help option.
The checks are done by “CHECK TABLES” sql command.


  • #288 Install command with –noDownload options fails if database exists
  • #290 Add force use database option for when installing with –noDownload (by Aydin Hassan)


  • #287 db:console closes connection on AWS
  • #295 Fixed typo in config.yaml (by Andrea De Pirro)
  • #296 loadXML must be called AFTER preserveWhiteSpace (by Volker Thiel)
  • #297 [Insight] Missing use statement should be avoided

Have fun!


New release 1.85.0 is ready for download

We wish you all a successful and productive year 2014. The current release adds new awesome features to n98-magerun.

What’s new?

Running Setup Resource Scripts Incrementally

This a great new feature by Alan Storm. If you are creating setup scripts as developer you must be sure that all your scripts
are executed in correct order.
The new commands brings you incremental execution of all setup script. This features is also a very handy if you update
a shop to a new Magento version. Now you can see what’s up on your database during a setup script run.
Please note that this feature is still experimental. Please let us know if you discover any problem.