🚀 AeroGear UnifiedPush Server
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
common [maven-release-plugin] prepare for next development iteration May 2, 2018
configuration remove experimental ams support (#996) Apr 27, 2018
databases Installation (#988) Apr 18, 2018
dependencies [maven-release-plugin] prepare for next development iteration May 2, 2018
dist [maven-release-plugin] prepare for next development iteration May 2, 2018
docker-compose update to KC 4.1.0 Jul 5, 2018
jaxrs Remove outdated comment May 14, 2018
migrator [maven-release-plugin] prepare for next development iteration May 2, 2018
model Merge branch 'master' into support-for-mutable-content May 15, 2018
node.js some cleanup Jun 26, 2015
openshift Fix and upgrade of OpenShift template (#955) Jan 16, 2018
proposals 🚀 adding old proposal to not loose it (#991) Apr 25, 2018
push-sender Add support for mutable-content key May 9, 2018
servers update to KC 4.1.0 Jul 5, 2018
service [maven-release-plugin] prepare for next development iteration May 2, 2018
.gitignore Remove Device form Topic based on previous categories Jun 20, 2016
.travis.yml Disabling sonar, since it breaks travis CI build Nov 28, 2017
LICENSE.txt Adding License file Aug 1, 2014
NOTICE.txt AGPUSH-696: use Exo2 font-face distributed with admin-ui Jun 5, 2014
README.md describe configuration vars in README May 2, 2018
TESTS.md Adding ref. link to multicast Mar 24, 2016
pom.xml [maven-release-plugin] prepare for next development iteration May 2, 2018
ups-ui-screenshot.png updated UI screenshot in README Jun 2, 2015


AeroGear UnifiedPush Server

Build Status License Maven Central

The AeroGear UnifiedPush Server is a server that allows sending push notifications to different (mobile) platforms and has support for:

Project Info

Project Info
License: Apache License, Version 2.0
Build: Maven
Documentation: https://aerogear.org/push/
Issue tracker: https://issues.jboss.org/browse/AGPUSH
Mailing lists: aerogear-users (subscribe)
aerogear-dev (subscribe)

Getting started

The easiest way to get started is running our plain Linux container:

mvn clean install -DskipTests && docker run -p 18081:8080 -it aerogear/ups:plain 

then go to http://localhost:18081/ to use the UPS.

For our on-premise version, and more infos on database setup, please consult our user guide!


For your convenience, we do have an easy way of launch different configurations of the UPS, using our Docker compose files


For more details about the current release, please consult our documentation.

Who is using it?

We have a list of users in our wiki. If you are using the UnifiedPush Server, please add yourself to the list!


Build the project:

mvn clean install

and start the latest build, locally, like docker run -p 18081:8080 -it aerogear/ups:plain


The Unified Push Server can be configured with either System Properties (passed to the Java commandline) or Environment Variables. The two options have different formats and the following list describes them using System Property Name/Env Var Name: Purpose.

  • custom.aerogear.apns.push.host/CUSTOM_AEROGEAR_APNS_PUSH_HOST: Custom host for sending Apple push notifications. Can be used for testing
  • custom.aerogear.apns.push.port/CUSTOM_AEROGEAR_APNS_PUSH_PORT: Custom port for the Apple Push Network host
  • custom.aerogear.fcm.push.host/CUSTOM_AEROGEAR_FCM_PUSH_HOST: Custom host for sending Google Firebase push notifications. Can be used for testing
  • ups.realm.name/UPS_REALM_NAME: Override Keycloak Realm
  • ups.auth.server.url/UPS_AUTH_SERVER_URL: Override Keycloak authentication redirect
  • aerogear.metrics.storage.days/AEROGEAR_METRICS_STORAGE_DAYS: Override the number of days the metrics are stored (default is 30 days)

Releasing the UnifiedPush Server

The content of the Release Process is valid for this project as well. However, to build the full distribution bundle, you need to fire off the release like:

## prepare the release and define the TAG and adjust the versions:
mvn release:prepare -Dtag=x.y.z.Final -Darguments=-Dgpg.passphrase=$MY_SECRET_PASS_PHRASE -Pdist,test

## run the actual release process and load the artifacts to JBoss Nexus
mvn release:perform -DperformRelease=true -Darguments=-Dgpg.passphrase=$MY_SECRET_PASS_PHRASE -Dgpg.useagent=true -Pdist,test


If you would like to help develop AeroGear you can join our developer's mailing list, join #aerogear on Freenode, or shout at us on Twitter @aerogears.

Also takes some time and skim the contributor guide

We are available on Sonarcloud.io if you want to help us reduce our technical debt or improve our test coverage check us out there. It's a great way to get involved with your first PR. Check out the excellent guide on running SonarQube locally for more information.


Join our user mailing list for any questions or help! We really hope you enjoy app development with AeroGear!

Found a bug?

If you found a bug please create a ticket for us on Jira with some steps to reproduce it.