Castellano

Sinotrack ST-90x device management platform built with Laravel 10 + PHP 8.1 and MySQL 8.

• PHP 8.1 or higher (bcmath bz2 intl mbstring opcache pdo_mysql pcntl redis sockets xsl zip)
• MySQL 8.0.12 or higher
• Redis

1. Create the database in MySQL.

2. Clone the repository.

git clone https://github.com/eusonlito/GPS-Tracker.git

3. Copy the .env.example file as .env and fill in the necessary variables.

cp .env.example .env

4. Install composer dependencies (remember that we always use the PHP 8.1 binary).

composer install --no-dev --optimize-autoloader --classmap-authoritative --ansi

5. Generate the application key.

php artisan key:generate

6. Regenerate the caches.

composer artisan-cache

7. Launch the initial migration.

php artisan migrate --path=database/migrations

8. Launch the seeder.

php artisan db:seed --class=Database\\Seeders\\Database

9. Fill Timezones GeoJSON.

php artisan timezone:geojson

10. Configure the cron job for the user related to the project:

* * * * * cd /var/www/tracker.domain.com && install -d storage/logs/artisan/$(date +"\%Y-\%m-\%d") && /usr/bin/php artisan schedule:run >> storage/logs/artisan/$(date +"\%Y-\%m-\%d")/schedule-run.log 2>&1

11. Create the main user.

php artisan user:create [email protected] --name=Admin --password=StrongPassword2 --enabled --admin

12. Configure the web server DocumentRoot to /var/www/project/public.

13. Profit!

Updating the platform can be done in a simple way with the composer deploy command executed by the user who manages that project (usually www-data).

1. Clone the repository.

git clone https://github.com/eusonlito/GPS-Tracker.git

2. [OPTIONAL] Copy file docker/.env.example to .env and configure your own settings

cp docker/.env.example .env

3. [OPTIONAL] Copy file docker/docker-compose.yml.example to docker/docker-compose.yml and configure your own settings

cp docker/docker-compose.yml.example docker/docker-compose.yml

4. Build docker images (will ask for the sudo password)

./docker/build.sh

5. Start containers (will ask for the sudo password)

./docker/run.sh

6. Create the admin user (will ask for the sudo password)

./docker/user.sh

7. Launch the Timezone GeoJSON fill (will ask for the sudo password)

./docker/timezone-geojson.sh

8. Open your web browser and goto http://localhost:8080

9. Remember to add a web server (apache2, nginx, etc...) as a proxy to add features as SSL.

10. If you are going to add or change the default ports for GPS Devices (8091) you must edit the gpstracker-app properties in docker-compose.yml to adapt them to your own configuration.

1. Update the project source

git pull

2. Build docker images (will ask for the sudo password)

./docker/build.sh

3. Start containers (will ask for the sudo password)

./docker/run.sh

4. Open your web browser and goto http://localhost:8080

The default port for devices with H02 protocol is 8091, but it can be customized on configuration panel (as admin).

To configure your device via SMS you can do it with the following command:

804{PASSWORD} {IP/HOST} {PORT}

You can configure the connection server in the device using either the IP or a HOST that will resolve internally BUT ONLY AT THE TIME OF RECEIVING THE COMMAND, so if the server does not have a fixed IP as soon as it changes you will stop receiving data from the device.

{PHONE}{PASSWORD} 1

896{PASSWORD}E00

710{PASSWORD}

803{PASSWORD} {OPERATOR}

804{PASSWORD} {IP/HOST} {PORT}

805{PASSWORD} {SECONDS}

809{PASSWORD} {SECONDS}

SLEEP{PASSWORD} {MINUTES}

151{PASSWORD}

011{PASSWORD}

010{PASSWORD}

777{PASSWORD-NEW}{PASSWORD-OLD}

RESTART

RCONF

php artisan user:create {--email=} {--name=} {--password=} {--enabled} {--admin}

The reset option allows you to reset the port in case it is being used.

php artisan server:start:all {--reset}

The reset option allows you to reset the port in case it is being used.

php artisan server:start {--port=} {--reset}

Screenshots are in spanish, you can change the system language to english.