- Java 8 JDK
- Play Framework v2.5.0
- PostgreSQL DB
- 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.templateand 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
activator runto 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
- A gazetteer dump file from the Digital Atlas of the Roman Empire (in Pelagios
Gazetteer Interconnection Format)
is included in the
- You can import this gazetteer to Recogito on the Gazetteer Administration page at http://localhost:9000/admin/gazetteers. Note that you need to be logged in with a user that has administrator privileges (e.g. the default 'recogito').
- WARNING the admin pages are work in progress. Don't expect any fancy functionality or styling there yet! Importing gazetteers can take a while, and there is no progress display yet. Bear with us. You can track progress through Recogito's JSON Place API at http://localhost:9000/api/places/search?q=*&pretty=true
- It's not possible to upload controlled vocabularies for persons, periods or events yet.
Running in production
- To test production mode before deploying, type
- 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
- Production deployment requires and ElasticSearch installation. (Recogito will automatically create an embedded ElasticSearch index if cannot find a running cluster. However we strictly recommend this only for development purposes!) For the time being, we recommend to stick to ElasticSearch version 1.7.
- Last but not least: another reminder to remove the default 'recogito' admin user - or at least change its password!
Recogito v2.0 is licensed under the terms of the Apache 2.0 license.