81 lines
4.8 KiB
Markdown
81 lines
4.8 KiB
Markdown
# μlogger [](https://travis-ci.com/bfabiszewski/ulogger-server)
|
||
|
||
This is a web application for real-time collection of geolocation data, tracks viewing and management.
|
||
Together with a dedicated [μlogger mobile client](https://github.com/bfabiszewski/ulogger-android) it may be used as a complete self hosted server–client solution for logging and monitoring users' geolocation.
|
||
|
||
## Live demo:
|
||
- http://ulogger-demo.herokuapp.com (test track upload with Android app and editing, login: demo, password: demo)
|
||
|
||
## Requirements:
|
||
- PHP 5.5 (5.4 with [password_compat](https://github.com/bfabiszewski/ulogger-server/blob/04b2b771398d8511bfa6fe8a85d58162bd32fc46/helpers/user.php#L24))
|
||
- 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)
|
||
- ajax
|
||
- 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)
|
||
- 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](https://github.com/bfabiszewski/ulogger-server/blob/master/scripts/setup.php#L21) 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](https://github.com/bfabiszewski/ulogger-server/blob/v0.2/config.default.php#L67).
|
||
- Folders `.docker/` and `.tests/` as well as composer files are needed only for development. May be safely removed.
|
||
|
||
## 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](https://github.com/bfabiszewski/ulogger-server/blob/master/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 .`.
|
||
|
||
## Tests
|
||
- Install tests dependecies.
|
||
- `composer 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"`
|
||
- Run tests
|
||
- `./vendor/bin/phpunit -c .tests/phpunit.xml`
|
||
|
||
## Todo
|
||
- improve track editing
|
||
- track display filters (accurracy, provider)
|
||
- improve interface on mobile devices
|
||
|
||
## Translations
|
||
- translations may be contributed via [Transifex](https://www.transifex.com/bfabiszewski/ulogger/).
|
||
|
||
## Donate
|
||
[](https://www.paypal.me/bfabiszewski)
|
||
 `bc1qt3uwhze9x8tj6v73c587gprhufg9uur0rzxhvh`
|
||
 `0x100C31C781C8124661413ed6d1AA9B1e2328fFA2`
|
||
|
||
## License
|
||
- GPL
|
||
- most icons come from [iconmonstr](https://iconmonstr.com)
|