Merge branch 'USERGRID-744' into two-dot-o-dev
tree: ddea2fa7205e743a53e21befc6a7d28cf72b0d4a
  1. .gitattributes
  2. .gitignore
  3. .usergridversion
  9. chop/
  10. docs/
  11. portal/
  12. release/
  13. sdks/
  14. stack/
  15. ugc/

Apache Usergrid

WARNING: This is the two-dot-o branch and work is underway here on a new persistence system for Usergrid. Not everything is working in this branch. If you want stability, you should be working against the master branch or a tag. We refer to the new persistence system as Core Persistence and you can find its modules in the stack/corepersistence directory.


Apache Usergrid is a multi-tenant Backend-as-a-Service stack for web & mobile applications, based on RESTful APIs. It is currently incubating at the Apache Software Foundation.

##Contributing We accept all contributions via our GitHub, so you can fork our repo (apache/incubator-usergrid) and then submit a PR back to us for approval. For larger PRs you'll need to have an ICLA form on file with Apache. For more information see our Contribution Workflow Policy, and specifically our External Contributors Guide.

##Build awesome apps with Usergrid!

Apache Usergrid provides all code necessary to build and power modern mobile applications. This includes the server stack, administrative portal website, SDKs in most popular languages, as well as command line tools.

Look for much more detailed README files in their corresponding subdirectories, or check out our website for more info.

  • The server-side stack, a Java 7 + Cassandra codebase that powers all of the features, is located under /stack. You can install dependencies and compile it with maven. See stack/ for instructions.

  • The admin portal is a pure HTML5+JavaScript app allowing you to register developers and let them manage their apps in a multi-tenant cluster. Located under /portal

  • SDKs for iOS, Android, HTML5/JavaScript, node.js, Ruby on Rails, pure Ruby, PHP, (server-side) Java, .Net / Windows, and Perl, located in their respective subdirectories under /sdks.

  • a command-line client “ugc” allowing you to complete most maintenance tasks, as well as queries in a manner similar to the mysql or the mongo shell, located under /ugc. You can install it on your machine with a simple sudo gem install ugc

##For more information See the Apache Usergrid web site.