Skip to content


Subversion checkout URL

You can clone with
Download ZIP
An HTTP (ReST) interface to the Couchbase-Lite database running on the device/emulator
Shell Java Ruby

Fixed #27

- It seems gradle does not work with nested sub-modules. updated submodules.
- Also, merged fix for #20
latest commit 91555d530d
@hideki hideki authored

LiteServ is an HTTP (ReST) interface to the Couchbase-Lite database running on the device/emulator.

Here's how it fits into the picture:


LiteServ effectively wraps Couchbase Lite and provides an API that can be accessed via HTTP.

It is useful for:

  • Using Couchbase-Lite inside of a LiteGap app (eg, a Couchbase-Lite app based on PhoneGap)
  • Easy access to data in a Couchbase-Lite database via curl for debugging
  • Testing
  • Doing pull replications where something else is pulling data from Couchbase-Lite

Getting LiteServ

git clone
cd couchbase-lite-android-liteserv
git submodule init && git submodule update

Import Project into Android Studio

Note: this project is known to work on Android Studio 0.4.3 and earlier 0.4.X versions, but is not working on Android Studio 0.4.4 or later due to this Android Studio bug

Follow the instructions in the following sections of the Couchbase Lite Android README on Importing Project into Android Studio:

Building and deploying maven artifacts.

If you want to host and deploy your own maven artifacts, see the extra/jenkins_build/ script.

Building LiteServAndroid via Gradle command line

Configure Android Studio SDK location

  • cp
  • Customize according to your SDK installation directory


$ ./gradlew clean && ./gradlew assemble

Running Unit tests

See Running unit tests for couchbase lite android

Running LiteServAndroid via Android Studio

Once the project is imported, just run the green arrow "play" button.

Running LiteServAndroid via Gradle command line

  • Define an AVD (android virtual device) if you have not already done so. This can be done by running $ android avd to launch the UI

  • Launch the emulator with that AVD. This can be done in the AVD manager UI, or on the command line via $ emulator64-arm -avd <avd_name> -netspeed full -netdelay none where avd_name is the name of the AVD you created in the previous step.

  • Call $ ./ 8080 to run it on port 8080. This should install the app into the emulator and launch it, and then setup a port forwarding rule so that 8080 on your workstation is mapped to port 8080 on the emulator.


Something went wrong with that request. Please try again.