CouchDB Grails


Integrate CouchDB with Grails

This quickstart guide will help you to integrate your Grails application with CouchDB service on App42 PaaS.


Kontena – Kontena is a lightweight container that will run your apps and services in an isolated and secured manner. You can specify the power of the Kontena while setting up infra or creating services. One Kontena power specifies to 256 MB Memory and 128 MHz CPU.

Service – Services in the App42 PaaS are add-on components which are needed in an App. App42 PaaS supports multiple services like SQL databases, NoSQL databases and more.


To get going with App42 PaaS, below are few prerequisites that will allow you to use AppHQ – App42 PaaS Management Console as well as Command Line Client.

Configure CouchDB credentials into Grails App

Once you have setup the Grails environment and created the CouchDB service, You need to configure the CouchDB credentials in your created Grails application.

// using grails

couchdb {
    host = "service_vm_ip"
    port = service_port
    database = "database_name"
    username = "username"
    password = "password"

// using couchdb4j.jar

String host = "service_vm_ip";
String username = "username";
String password = "password";
String dbName = "database_name";
int port = service_port;   // eg, 23453

Session session = new Session(host, port, username, password);  
Database db = session.getDatabase(dbName);  

You can also use our Sample Apps and extend it to suit your needs. Here is the link to Grails-CouchDB Sample App

Update Application

After doing all the modifications to your App, you need to update it on App42 PaaS to get the changes affected in your App running on App42 PaaS platform.

$ app42 update
Enter App Name: testGrails
1: Binary
2: Source
Choose Upload Type [Binary]: 2

Updating Application... OK

Operation is in progress, Please wait...-
App deployed successfully.