Current version: v3.0-RC

Home of Recogito - a Linked Data annotation tool for texts and images, developed by Pelagios. Track our progress on Waffle.io.

• Java 8 JDK
• SBT (version 1.0.x)
• PostgreSQL DB (tested with version 9.5)
• Important: as of version 2.2, Recogito requires an installation of ElasticSearch v5.6.5. Automatic fallback to an embedded ElasticSearch index is no longer supported.
• To use image annotation, you need to have the vips image processing system installed. If vips is not available on the command line, Recogito is set to reject uploaded images as 'unsupported content'. (Note: on Ubuntu, 'libvips-tools' is the package you need.)

• Clone this repository
• Create a copy of the file conf/application.conf.template and name it conf/application.conf. Make any environment-specific changes there. (For the most part, the defaults should be fine.)
• Create a database named 'recogito' on your Postgres DB server. (If you want a different name, adjust the settings in your conf/application.conf accordingly.)
• Type sbt run to start the application in development mode.
• Point your browser to http://localhost:9000
• Recogito automatically creates a single user with administrator privileges with username 'recogito' and password 'recogito'. Be sure to remove this user - or at least change the password - for production use!
• To generate an Eclipse project, type sbt eclipse.

Documentation on how to import gazetteers is on the Wiki.

• To test production mode before deploying, type sbt runProd
• To change to a different port (than default 9000), type sbt "runProd -Dhttp.port=9876"
• For full production deployment, refer to the current Play Framework docs
• Be sure to set a random application secret in conf/application.conf. Play includes a utility to generate one for you - type sbt playGenerateSecret.
• Last but not least: another reminder to remove the default 'recogito' admin user - or at least change its password!

Recogito is licensed under the terms of the Apache 2.0 license.