bfabiszewski/ulogger repository overview

⁠μlogger  

This is a web application for real-time collection of geolocation data, tracks viewing and management. Together with a dedicated μlogger mobile client⁠ it may be used as a complete self hosted server–client solution for logging and monitoring users' geolocation.

⁠Live demo:

• https://ulogger.lima.zone⁠
• for testing track upload with Android app or track editing login with user: demo, password: demo
• hosted by lima-city.de

⁠Minimum requirements:

• PHP 5.5
• PHP extensions: ctype, json, pdo (with respective drivers), session, simplexml, xmlwriter, xdebug (only for tests)
• MySQL, PostgreSQL or SQLite (over PDO driver)
• browser with javascript enabled, cookies for authentication and saving preferences

⁠Features:

• simple
• allows live tracking
• track statistics
• altitudes graph
• multiple users
• user authentication
• Google Maps
• OpenLayers (OpenStreet and other layers)
• user preferences stored in cookies
• simple admin menu
• export tracks to gpx and kml
• import tracks from gpx

⁠Install

• Download zipped archive or clone the repository on your computer
• Move it to your web server directory (unzip if needed)
• Fix folder permissions: uploads folder (for uploaded images) should be writeable by PHP scripts
• In case of development version it is necessary to build javascript bundle from source files. You will need to install npm and run npm install and npm run build in root folder
• Create database and database user (at least SELECT, INSERT, UPDATE, DELETE privileges, CREATE, DROP for setup script, SEQUENCES for postgreSQL)
• Create a copy of config.default.php and rename it to config.php. Customize it and add database credentials
• Edit scripts/setup.php script, enable it by setting $enabled⁠ value to true
• Make sure you have a web server running with PHP and chosen database
• Open http://YOUR_HOST/ulogger-server/scripts/setup.php page in your browser
• Follow instructions in setup script. It will add database tables and set up your μlogger user
• Remember to remove or disable scripts/setup.php script
• Log in with your new user on http://YOUR_HOST/ulogger-server/
• You may also want to set your new user as an admin in config file⁠
• Folders .docker/ and .tests/ as well as composer files are needed only for development. May be safely removed

⁠Upgrade to version 1.x

• Incompatible changes include database and config file changes
• Upgrading manually:
  • for database changes, see MySQL example script in scripts/migrate_to_1_x.mysql
  • set admin column in users table to true for admin users
  • edit configuration from application settings dialog
• Upgrading with migration script from version 0.6:
  • create database backup
  • replace all project files with new ones, but keep old local config file: config.php
  • change directory to application root folder and run migration script from the console: php scripts/migrate_to_1_x.php
  • the script will update database schema and save old config variables to database
• Additional tasks after manual or script update:
  • edit your config.php file and remove all variables except database settings, see config.default.php⁠ for valid values
  • make sure uploads folder (for images uploaded from client app) is writable by PHP
  • clear browser cache and restart web page

⁠Docker

• Run docker run --name ulogger -p 8080:80 -d bfabiszewski/ulogger and access http://localhost:8080 in your browser. Log in with admin:admin credentials and change default password
• Optional configuration options with ENV variables, for list see Dockerfile⁠. The variables correspond to main μlogger configuration parameteres
• For example: docker run --name ulogger -e ULOGGER_LANG="pl" -p 8080:80 -d bfabiszewski/ulogger
• You may also build the image yourself. Run docker build . from the root folder where Dockerfile reside. There are optional build-time arguments that allow you to set default database passwords for root and ulogger users
• For example: docker build --build-arg DB_ROOT_PASS=secret1 --build-arg DB_USER_PASS=secret2 --build-arg DB_DRIVER=sqlite .
• Docker was created to facilitate development and testing. It is not production ready. If you want to use it in production, you will have to adjust it to your needs.

⁠Tests

• Install tests dependecies. PHP tests require PHP >= 7.3.
  • composer install
  • npm install
• Integration tests may be run against docker image. We need exposed http and optionally database ports (eg. mapped to localhost 8080 and 8081). Below example for MySQL setup
  • docker build -t ulogger .
  • docker run -d --name ulogger -p 8080:80 -p 8081:3306 --expose 3306 -e ULOGGER_ENABLE_SETUP=1 ulogger
• Use environment variables (or create .env file in .tests/ folder) to set up connection details (below database credentials are docker defaults)
  • DB_DSN="mysql:host=127.0.0.1;port=8081;dbname=ulogger;charset=utf8"
  • DB_USER=ulogger
  • DB_PASS=secret2
  • ULOGGER_URL="http://127.0.0.1:8080"
• PHP tests
  • XDEBUG_MODE=coverage ./vendor/bin/phpunit -c .tests/phpunit.xml
• JS tests
  • npm test
• Other tests
  • npm run lint:js
  • npm run lint:css

⁠Translations

• translations may be contributed via Transifex⁠

⁠Donate

bc1qt3uwhze9x8tj6v73c587gprhufg9uur0rzxhvh
0x100C31C781C8124661413ed6d1AA9B1e2328fFA2

⁠License

• GPL
• most icons come from iconmonstr⁠