Software package preparation

  1. Make sure Microsoft .NET Framework 4.5.2 is installed. It can be downloaded here:
  2. Send us to This email address is being protected from spambots. You need JavaScript enabled to view it. full domain which is pointed to server IP where software will be installed.
  3. Package download link will be delivered via e-mail during 24 hours.

Installation preparation

  1. Download software package and extract it.
  2. Make sure that you have Plesk with IIS or WAMP environment installed with PHP 5.4, 5.5 or 5.6 and MySQL 5.6 or above versions.
  3. Set "short_open_tag" to "On" in php.ini.
  4. Let's say you would like to access installed software via domain and folder "track". Then "YOUR_DOMAIN/track" is full web address to installed software.

Web part installation

  1. Open phpMyAdmin from web server (IIS, WAMP, XAMP or others) and create new database.
  2. Set created database username and password.
  3. Select your database from list on the left and open "SQL" tab. You will see big text box.
  4. From software package open "database\db.sql" with text editor.
  5. Copy and paste everything to "SQL" tab text box and click "Go".
  6. If everything is correct it will create needed tables for your database.
  7. From software package open "track\config.php" with text editor and set important variables:
    • $gsValues['PATH_ROOT'] = 'LOCAL_PATH_TO_ROOT';
    • $gsValues['URL_ROOT'] = 'http://YOUR_DOMAIN/track';
    • $gsValues['HW_KEY'] = 'YOUR_HARDWARE_KEY';
    • $gsValues['DB_HOSTNAME'] = 'localhost';
    • $gsValues['DB_PORT'] = '3306';
    • $gsValues['DB_NAME'] = 'YOUR _DATABASE_NAME';
  8. Using file manager or FTP client create folder "track" on web server. It should be accessible like this "YOUR_DOMAIN/track".
  9. From software package upload "track" folder contents to created "track" folder on web server.
  10. Set CHMOD 777 for:
    • "YOUR_DOMAIN/track/config.custom.php"
    • "YOUR_DOMAIN/track/data/img"
    • "YOUR_DOMAIN/track/data/user/drivers"
    • "YOUR_DOMAIN/track/data/user/kml"
    • "YOUR_DOMAIN/track/data/user/objects"
    • "YOUR_DOMAIN/track/data/user/places"
    • "YOUR_DOMAIN/track/data/user/reports"
    • "YOUR_DOMAIN/track/img"
    • "YOUR_DOMAIN/track/lng"
    • "YOUR_DOMAIN/track/logs"
  11. Now you should be able to access web application using this link: "YOUR_DOMAIN/track"
    • Login: admin
    • Password: 123456
  12. After login to Control panel go to Manage server section, E-mail tab and configure e-mail, otherwise users will not be able to register.

Server part installation

  1. From software package copy "gs" folder to "c:\gs".
  2. Run "c:\gs\gps-server.exe". Enable all needed protocols from the list and click "Save".
  3. With mouse right click open menu on "c:\gs\service\install_win32.bat" or "c:\gs\service\install_win64.bat" file and select "Run as administrator".
  4. Select "Path" to "c:\gs\". Startup directory should be "c:\gs".
  5. Click "Install service".
  6. Execute "services.msc" from "Run" tool under Windows OS Start menu.
  7. Find "GPS-server" and make sure "Startup type" is set as "Automatic".
  8. Restart your server and if everything was done right, "GPS-server" should work as a service application.
  9. In case you want to change settings, run "c:\gs\gps-server.exe" application.


  • Server -  server domain where software is installed (set by license key).
  • Hardware key - unique server key, used for some server services.


  • Autorestart server interval - restarts TCP/IP and UDP listeners after set period of time.
  • Check commands interval - checks for new commands to be delivered to GPS devices.
  • Upload messages interval - period of time after which data from GPS devices is being uploaded to database.
  • Upload messages - max batch size - number or locations uploaded by thread in one packet.
  • Upload messages - max degree of parallelism - number of upload threads, which upload data independently at same time to database.
  • Upload demo messages from CSV files - GPS device CSV exported tracks uploader.
  • Message filter - filters duplicate points during last minutes and eliminates some drifting when GPS device signal is low.
  • Message filter - event min time - skips location data if time period is lower between current and last location, prevents location message flood.
  • Message filter - message max age (in hours) - prevents too old location upload from GPS device buffer.
  • Connection timeout time - period of time after which GPS device will be disconnected from server in case no data is received.
  • TCP max buffer size - max amount of bytes during one message via TCP/IP.

Do not forget to make backup

Once you get your GPS server running, do not forget to make backup of "c:\gs" folder contents. Also make regular backups of "YOUR_DOMAIN/track" and your GPS server MySQL database.