Troubleshooting rake aborted! Error

Introduction

This guide will help you fix the rake aborted! LoadError: cannot load such file -- sass error that can appear during the installation or upgrade of Easy8. The error occurs during assets compilation and blocks the upgrade process. By following the steps below, you can resolve this issue and continue with your upgrade.

Target Audience

• Administrator

Prerequisites

• Access to the Easy8 file system
• Ability to edit Ruby files (e.g., Gemfile)
• Command-line access for running Ruby and bundle commands

How to Fix the rake aborted! Sass LoadError

Step 1: Understand the Problem

The error message looks like this:

rake aborted!
LoadError: cannot load such file -- sass
...
Tasks: TOP => assets:precompile

This occurs because:

• New versions of sassc-ruby (since 2.0) no longer include sass as a dependency.
• Older Easy8 versions relied on this.
• This issue was fixed in newer versions but may appear during upgrades from old packages.

Step 2: Open the Gemfile

• Open the following file in a text editor:

plugins/easyproject/Gemfile

• Locate this line:

gem 'sassc', '>= 1.12.1'

Step 3: Edit the Gemfile

Change it to:

gem 'sassc', '1.12.1'

This pins the version and avoids the incompatible behavior introduced in later versions.

Step 4: Reinstall Bundled Gems and Re-run Installer

Run the following commands:

bundle install
bundle exec rake easyproject:install

This will recompile the assets with the correct dependency.

Step 5: Resume the Upgrade

After fixing the dependency, continue with your regular upgrade process.

Conclusion

You have successfully resolved the rake aborted! error caused by a missing sass dependency. This issue affects older Easy8 versions but is resolved in versions from 2018.1.3 (platform 05.02) onward.

Related Topics and Further Reading

• sassc-ruby change log
• Ruby-sass deprecation notice
• Easy8 Documentation
• Easy Project Documentation