Lightweight, embedded, syncable NoSQL database engine for Android.
Clone or download
jamiltz and pasin Remove asciidocs and sample code (#1740)
* remove docs folder

* remove unit tests
Latest commit 34d44d8 Jun 19, 2018

Couchbase Lite 2.0

Couchbase Lite is an embedded lightweight, document-oriented (NoSQL), syncable database engine.

Couchbase Lite 2.0 has a completely new set of APIs. The implementation is on top of Couchbase Lite Core, which is also a new cross-platform implementation of database CRUD and query features, as well as document versioning.


  • Android 4.4+ (API 19+)
  • Supported architectures: armeabi-v7a, arm64-v8a and x86
  • Android Studio 3.+


Download the latest AAR or grab via Maven



Add the following in the dependencies section of the application's build.gradle (the one in the app folder).

dependencies {
    implementation 'com.couchbase.lite:couchbase-lite-android:2.0.0'




How to build from source

  1. git clone --recursive to clone this repo and it's submodules
  2. In Android Studio, open the android subdirectory
  3. Install CMake

At this point it should build without errors.

Sample Apps


If you are using ProGuard you might need to add the following options:

# OkHttp3
-dontwarn okhttp3.**
-dontwarn okio.**
-dontwarn javax.annotation.**
-dontwarn org.conscrypt.**
# A resource is loaded with a relative path so the package of this class must be preserved.
-keepnames class okhttp3.internal.publicsuffix.PublicSuffixDatabase

# CBL2.x
-keep class com.couchbase.litecore.**{ *; }
-keep class com.couchbase.lite.**{ *; }


Apache 2 license.