Public Repository

Last pushed: a year ago
Short Description
Easyrec is an open-source program that provides personalized recommandation system.
Full Description

Easyrec v1.0.4

The easyrec project is an open source recommendation system providing a low barrier entrance to high quality recommendations to any website with personalization needs.

Docker image for Easyrec Server 1.0

What is Easyrec?

The easyrec project is an open source recommendation system providing a low barrier entrance to high quality recommendations to any website with personalization needs. The access to easyrec is provided through Web services assuring an easy and quick integration. Immediate deployment is possible for web sites (e.g. scripts enclosing API calls, placed in the client's pages, see below). Its focus is simple integration; In most cases, the web-based administration interface should be sufficient for configuring easyrec.
easyrec is an open source Web application that provides personalized recommendations using RESTful Web services to be integrated into Web enabled applications. It is distributed under the GNU General Public License by the Studio Smart Agent Technologies and hosted at SourceForge. It is written in Java, uses a MySQL database and comes with an administration tool.

In this wiki you will find the documentation of the easiest to use open source recommender. If you have any further questions don't hesitate to contact us at the forums. If you are completely new to easyrec you may want to see how to get started. You might also want to have a glimpse at the frequently asked questions(FAQ).
For instructions on installing easyrec on your server, read the Installation Guide.


A major feature of easyrec is a set of usage statistics and other business relevant information presented via an administration and management interface. Furthermore, the easyrec administrator is supported by a variety of administration and configuration functions including the manual import or adaptation of business rules. Integrators and developers benefit from the lightweight Web service APIs (REST and SOAP) as well as the guided installation wizard.
easyrec provides the following personalization services:
unpersonalized recommendations of the form "other users also bought/viewed/...", etc.

  • personalized recommendation depending on individual preferences
  • rankings such as "most bought items", "most viewed...", etc.
  • manual clustering of the items (e.g. SUMMER SALE 2011)
  • using item types (e.g. BOOK, DVD, MP3) for in type-specific recommendations
  • a plugin system for the rule generators

Additionally, as an integration showcase, a drupal ubercart extension was developed. For more information about the history of easyrec read the wikipedia article.


We're hosting a demo instance, so if you want to play around with easyrec start at and create an account. Then check the easyrec version deployed on our server and read the documentation for this version to get started.


The following links lead you to the documentations of the given version:

Container based on with working init process and syslog. For more information on how to set upp services, please read the documentation for nimmis/mariadb

Starting the container

To run the lastest stable version of this docker image run

docker run -d verdeit/easyrec-docker

To expose the web server and database to the external interface run

docker run -d -p 3306:3306 -p 8080:8080 --name easyrec verdeit/easyrec-docker

docker exec -d easyrec /etc/init.d/ start

After tomcat startup, go to apache home


Easyrec path


Tomcat User: admin
Tomcar Pass: password

Installing Easyrec

Mysql user data:

Database Host : localhost
Database Name : easyrec
User Name : easyrecuser
Password : admin

Check MySQL improvements and initialize database. This process can last between 1,5 to 3 minutes.
Rest API is checked by default. Check if is development environment or/and continue. Wait for database migrations.
Next, create the admin user account. whala! If u are in easyrec dashboard, that`s all be ok.

Docker Pull Command