jEspresso

Free Captive Portal for Ubiquiti Unifi networks

Your own independent hotspot

JEspresso is an modern and customizable Espresso fork, written in Java/Typescript. Useful for setup custom hotspots without pay external cloud services. Works with Ubiquiti Unifi controller 4.X and 5.X (it doesn't support Dream Machine yet) and you can install it on small systems like Raspberry Pi 3 B+ (recommended 4)

It does not require any external web server and it can runs as a standalone application.

alt tag

FEATURES BASIC VERSION

  • Mac address authentication for free limited-time wifi access;
  • Remaining time counter for users (you can show them fake values, hiding minutes from remaining time);
  • Blocking expired session's mac-address for a range time
  • Single landing page (default theme built with Angular 9)
  • Single administration panel (basic default version built with Angular 9 and Bootstrap 4)
  • Webserver independent: you don't need Apache or Nginx to run it, it has embedded Tomcat Server (built with Springboot)
  • DBMS multiplatform: based on JPA, it supports PostgreSQL, MySQL and H2, SQLite is still experimental.

REQUIREMENTS FOR DOCKER RUNNING

  • Ubiquiti Unifi Controller (tested on 4.8.20 version)
  • Linux or Windows platform with Docker

REQUIREMENTS FOR STANDALONE JAR RUNNING

  • Ubiquiti Unifi Controller (tested on 4.8.20 version)
  • Linux or Windows with Java 8 or later
  • PostgreSQL or MySQL server (optional if you want use H2 persistence), SQLite support is under development

DO YOU NEED MORE?

If you need customized features (i.e. email, newsletter, social integration, users authentication or microservices architecture), you can contact me for commercial support.

LICENSE

This basic version is released under Apache2 License. Custom/commercial version can be released with a different license.

AUTHOR

Emanuele Paiano - nixw0rm [at] gmail [dot] com | Home page

CONTRIBUTORS

Julian Ellmaier and his team for suggestions and testing

Donate

If you like this project, consider a little donation, so I can buy new hardware for testing and development. At least you can offer me a coffee.. :)

paypal