μlogger logo

μlogger

  •  0 ratings
In category: Maps and Global Positioning System (GPS)

About μlogger

Collect geolocation from users in real-time and display their GPS tracks on a website.

  •   419  
  •   0  
  •   0  
  •   0  
Github stats:
  •  Commits: 582  
  •   444  
  •   79  
  •  Latest commit: May 5, 2023  

Deploy this app to Linode with a free $100 credit!

Languages/Platforms/Technologies:
Lincenses:

More about μlogger

ulogger_logo_smallμlogger Build Status

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

Donate paypal
Donate bitcoin bc1qt3uwhze9x8tj6v73c587gprhufg9uur0rzxhvh
Donate ethereum 0x100C31C781C8124661413ed6d1AA9B1e2328fFA2

License

Comments (0)

Please login to join the discussion on this project.

μlogger Reviews (0)

Overall Rating

None

based on 0 ratings

Please login to review this project.

No reviews for this project yet.

↑ back to top

pCloud Lifetime

Popular Projects

FluxBB

in Social Networks and Forums
 33k    0    0    0  

Nextcloud

in File Transfer & Synchronization
 20k    1    1    0  

Libreddit

in Social Networks and Forums
 7k    0    1    0  

Dashboard

in Personal Dashboards
 6k    0    0    0  

Audiobookshelf

in Audio Streaming
 5k    0    1    0  

CasaOS

in Self-hosting Solutions
 5k    0    0    0  

Mediagoblin

in Photo and Video Galleries
 4k    0    0    0  

Most Discussed

Nextcloud

in File Transfer & Synchronization
 20k    1    1    0  

Tube Archivist

in Automation
 3k    0    1    0  

OneDev

in Project Management
 2k    0    0    0  

iodine

in Proxy
 2k    0    0    0  

Alf.io

in Booking and Scheduling
 2k    0    0    0  

sysPass

in Password Managers
 1k    0    0    0  

Misskey

in Social Networks and Forums
 2k    0    0    0  
Linux VPS from $11/yr.
RackNerd VPS for $11.38/mo

Top Rated Projects

Gitea

 1 rating
in Project Management

Bagisto

 1 rating
in E-commerce

LinkAce

 1 rating
in Bookmarks and Link Sharing

Pydio

 1 rating
in File Transfer & Synchronization

Audiobookshelf

 1 rating
in Audio Streaming

Nextcloud

 1 rating
in File Transfer & Synchronization

Seafile

 1 rating
in File Transfer & Synchronization

Categories

You May Also Be Interested In

OpenGTS logo
OpenGTS cover

OpenGTS

Entry-level fleet tracking system. Supports variety of trac…

OwnTracks Recorder logo
OwnTracks Recorder cover

OwnTracks Recorder

Store and access data published by OwnTracks location track…

H3 Viewer logo
H3 Viewer cover

H3 Viewer

View/search Uber H3 (Hexagonal Hierarchical Spatial Index) …