Skip to content
Server application for iBeacon management
Java Shell
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.


Server application for iBeacon management.

Setting up

You need to have MySQL running, with an empty database. The server will set the database tables up itself. To point the server to the correct database, you have to fill the correct values (like the database credentials, IP address, etc.) in the property file called and put it to the root of the repository.

A dummy file is provided in the Docker folder.

Test Run

To test the server by running it, execute ./gradlew tomcatRunWar for *nix, or gradlew.bat tomcatRunWar for Windows.


By executing ./gradlew war (or gradlew.bat war for Windows), you can create a WAR file of the server, which you can deploy to a Tomcat instance. The WAR file will be inside build/libs/.

iBeacon Docker container

To use iBeacon server inside a Docker container:

  1. Take the files in the Docker folder, put them inside a seperate folder. For example:

        |-- Dockerfile
        |-- server.xml
        |-- web.xml
  2. Fill the database server information in the file.

  3. Run the script, which will create the necessary folders and the keystore used by the Tomcat instance inside the container, build the Docker container, and run it. The default settings are not really secure (like the keystore settings) but it will provide a good starting point. These settings should be changed by the administrator for proper security.

You can’t perform that action at this time.