wieerwill/self-hosted-cookbook
1
0
Fork 0
mirror of https://github.com/tborychowski/self-hosted-cookbook.git synced 2025-06-27 05:05:24 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

cleaup

Browse Source
This commit is contained in:
Dziad Borowy 2023-01-17 23:26:25 +00:00
parent c655ff007f
commit fd3768dbff
1 changed files with 85 additions and 109 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

188
apps/other/traccar.md
View File

@ -1,23 +1,22 @@
# Traccar # Traccar
![traccar_hu4f4d748acb69c0f52e2340aac180cda5_35275_1600x0_resize_box_3](https://user-images.githubusercontent.com/52239579/212997283-e3279b61-189f-452c-86e5-d1e2fe216da2.png) Traccar is a gps tracking system. You can use it to monitor your smartphone location history
**Traccar is a gps tracking system. You can use it to monitor your smartphone location history**
<br> <br>
[website](https://www.traccar.org/) - [website](https://www.traccar.org/)
- [documentation](https://www.traccar.org/documentation/)
[documentation](https://www.traccar.org/documentation/)
## get the default traccar conf ## get the default traccar conf
`docker run --rm --entrypoint cat debian-traccar-nginx:latest /opt/traccar/conf/traccar.xml > /run/media/ippo/TOSHIBA/traccar/conf/traccar.xml` ```sh
docker run --rm --entrypoint cat debian-traccar-nginx:latest /opt/traccar/conf/traccar.xml > /run/media/ippo/TOSHIBA/traccar/conf/traccar.xml
```
## Configuration parameters for MySQL ## Configuration parameters for MySQL
(replace [DATABASE], [USER], [PASSWORD] with appropriate values from docker-compose replace [HOST "IPv4Address" from db_name section in docker network inspect) Replace [DATABASE], [USER], [PASSWORD] with appropriate values from `docker-compose.yml` replace `[HOST]` with IPv4 address from `db_name` section in `docker network inspect`:
``` ```xml
<entry key='database.driver'>com.mysql.cj.jdbc.Driver</entry> <entry key='database.driver'>com.mysql.cj.jdbc.Driver</entry>
<entry key='database.url'>jdbc:mysql://[HOST]:3306/[DATABASE]?serverTimezone=UTC&amp;allowPublicKeyRetrieval=true&amp;useSSL=false&amp;allowMultiQueries=true&amp;autoReconnect=true&amp;useUnicode=yes&amp;characterEncoding=UTF-8&amp;sessionVariables=sql_mode=''</entry> <entry key='database.url'>jdbc:mysql://[HOST]:3306/[DATABASE]?serverTimezone=UTC&amp;allowPublicKeyRetrieval=true&amp;useSSL=false&amp;allowMultiQueries=true&amp;autoReconnect=true&amp;useUnicode=yes&amp;characterEncoding=UTF-8&amp;sessionVariables=sql_mode=''</entry>
<entry key='database.user'>[USER]</entry> <entry key='database.user'>[USER]</entry>
@ -26,147 +25,122 @@
## docker-compose ## docker-compose
``` ```yaml
version: "3" ---
services: services:
traccar-db: traccar-db:
#yobasystems was used for its compact size. also it survives recomposing and does not throws innodb error when volumes are not empty as the official mariadb image does
image: yobasystems/alpine-mariadb image: yobasystems/alpine-mariadb
container_name: traccar-db container_name: traccar-db
#auth plugin for old drivers restart: unless-stopped
command: --default-authentication-plugin=mysql_native_password command: --default-authentication-plugin=mysql_native_password
restart: always networks:
volumes: - trc2
# mount /var/lib/mysql and /etc/mysql/conf.d on host
- /run/media/ippo/TOSHIBA/traccar/mysql-data:/var/lib/mysql
- /run/media/ippo/TOSHIBA/traccar/mysql:/etc/mysql/conf.d
ports:
- "3306:3306"
environment: environment:
#use those in the traccar config file in /opt/traccar/conf/traccar.xml as mounted in host
- MYSQL_ROOT_PASSWORD=rootpassword - MYSQL_ROOT_PASSWORD=rootpassword
- MYSQL_DATABASE=traccar-db - MYSQL_DATABASE=traccar-db
- MYSQL_USER=username - MYSQL_USER=username
- MYSQL_PASSWORD=userpassword - MYSQL_PASSWORD=userpassword
networks: volumes:
- trc2 - ./mysql-data:/var/lib/mysql
- ./mysql:/etc/mysql/conf.d
ports:
- "3306:3306"
traccar: traccar:
image: traccar/traccar:debian image: traccar/traccar:debian
#create an account to a dynamic dns provider e.g. duckdns then reverse proxy it to localhost:traccar_port e.g. with caddy. Caddyfile is dead simple hostname: <server IP>
hostname: a_ddns_domain_name
container_name: traccar container_name: traccar
restart: unless-stopped
depends_on: depends_on:
- traccar-db - traccar-db
restart: always
volumes:
#get the default traccar conf
#then replace the embeded h2 db conf with "mysql" conf
#https://www.traccar.org/mysql/
#get the network subnet and ip
#docker network inspect network_name in the database section
#use the ip in the [hostname] section of the database url database.url'>jdbc:mysql://[HOST]/[DATABASE]?
- /run/media/ippo/TOSHIBA/traccar/conf/traccar.xml:/opt/traccar/conf/traccar.xml:ro
- /run/media/ippo/TOSHIBA/traccar/logs:/opt/traccar/logs:rw
ports:
#android client needs tcp 5055 port so if you dont plan to use any of the supported hardware gps trackers
#you can skip listening to 5002,5093 tcp/udp ports and only keep 5055 for events and 8082 for the webui
- "5055:5055"
- "82:8082"
networks: networks:
- trc2 - trc2
ports:
- "5055:5055"
- "82:8082"
volumes:
- ./traccar.xml:/opt/traccar/conf/traccar.xml:ro
- ./logs:/opt/traccar/logs:rw
networks: networks:
trc2: trc2:
driver: bridge driver: bridge
enable_ipv6: false enable_ipv6: false
ipam: ipam:
config: config:
#get the network subnet # get the network subnet: `docker network inspect network_name`
#docker network inspect network_name
- subnet: 192.168.112.0/20 - subnet: 192.168.112.0/20
``` ```
## open root mysql shell create database, charset and priviledget user ## open root mysql shell create database, charset and priviledget user
`docker exec -it traccar-db mysql -u root -p` ```sh
docker exec -it traccar-db mysql -u root -p
```
`CREATE DATABASE IF NOT EXISTS traccar-db` ```sql
CREATE DATABASE IF NOT EXISTS traccar-db
grant all privileges on traccar-db.* TO user'@'% identified by pass
flush privileges
ALTER DATABASE traccar CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ciALTER DATABASE traccar CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci
\q
```
`grant all privileges on traccar-db.* TO user'@'% identified by pass`
`flush privileges` ## Tips & tricks
`ALTER DATABASE traccar CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ciALTER DATABASE traccar CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci` ### Backup traccar mysql
`\q` ```sh
docker compose -f compose-file.yml exec dbname mysqldump -uroot -pYOUR_MARIADB_ROOT_PASSWORD --all-databases > dump-$(date +%F_%H-%M-%S).sql
```
## reverse proxy ### Restore traccar mysql
i recoment to use caddy for reverse proxy and automatic ssl manager ```
docker compose -f compose-file.yml exec -T dbname mysql -uroot -pYOUR_MARIADB_ROOT_PASSWORD < mariadb-dump.sql
```
`nano /etc/caddy/Caddyfile` ### Android apps
`a.random.ddns.name.duckdns.org {
reverse_proxy localhost:82
}`
## backup and restore traccar mysql
backup
`docker-compose -f compose-file.yml exec dbname mysqldump -uroot -pYOUR_MARIADB_ROOT_PASSWORD --all-databases > dump-$(date +%F_%H-%M-%S).sql`
restore
`docker-compose -f compose-file.yml exec -T dbname mysql -uroot -pYOUR_MARIADB_ROOT_PASSWORD < mariadb-dump.sql`
## android apps
[Android client app](https://www.traccar.org/client/)
- [Android client app](https://www.traccar.org/client/)
On client app While service is deactivated Copy the identifier, Insert the server URL (your dens,domain), Select location accuracy (high), Select frequency report ~120 sec, disable wakelock and enable the service On client app While service is deactivated Copy the identifier, Insert the server URL (your dens,domain), Select location accuracy (high), Select frequency report ~120 sec, disable wakelock and enable the service
On status verify that the location is updating On status verify that the location is updating
[Android manager app](https://www.traccar.org/manager/) - [Android manager app](https://www.traccar.org/manager/)
On server Top left menu Select the plus icon to add a device Select a random name And the identifier from the client app And save On server Top left menu Select the plus icon to add a device Select a random name And the identifier from the client app And save
The you can select the device on the top left menu The you can select the device on the top left menu
![Screenshot_20230117-214656_Traccar Manager](https://user-images.githubusercontent.com/52239579/212997717-452c1e22-b244-4f50-8806-a61daa2a9485.png)
### Migrate google location history takeout to traccar
## Migrate google location history takeout to traccar
[download your google maps location history takeout](https://takeout.google.com/takeout/custom/local_actions,location_history,maps,mymaps?) [download your google maps location history takeout](https://takeout.google.com/takeout/custom/local_actions,location_history,maps,mymaps?)
select location history only - select location history only
and json as format - and json as format
extract the Records.json - extract the Records.json
you'll use a python script to limit the resaults to just time , latitude and longitude converted to proper coordinates you'll use a python script to limit the resaults to just time , latitude and longitude converted to proper coordinates
`git clone https://github.com/Scarygami/location-history-json-converter` ```sh
git clone https://github.com/Scarygami/location-history-json-converter
`cd location-history-json-converter` cd location-history-json-converter
pip install -r requirements.txt
`pip install -r requirements.txt` python location_history_json_converter.py Records.json output.csv -f csv
```
`python location_history_json_converter.py Records.json output.csv -f csv`
csv output will generate Comma-separated text file with a timestamp field and a location field csv output will generate Comma-separated text file with a timestamp field and a location field
we'll add a deviceid , protocol and valid fileds to it we'll add a deviceid , protocol and valid fileds to it
`sed 's/^/osmand,1,/; s/$/,1/' export.csv > curated.csv` ```sh
sed 's/^/osmand,1,/; s/$/,1/' export.csv > curated.csv
delete the "1" from the first line an replace osmand with protocol in the first line
so now the file looks like
``` ```
delete the "1" from the first line an replace osmand with protocol in the first line, so now the file looks like
```csv
protocol,Time,Latitude,Longitude protocol,Time,Latitude,Longitude
osmand,1,2012-08-25 21:26:20,37.95954620,23.72793730,1 osmand,1,2012-08-25 21:26:20,37.95954620,23.72793730,1
``` ```
@ -180,20 +154,22 @@ lon
We are going to parse those values to as sql `LOAD DATA LOCAL INFILE` statement to the appropriate tc_position table fields We are going to parse those values to as sql `LOAD DATA LOCAL INFILE` statement to the appropriate tc_position table fields
copy the csv to the container - copy the csv to the container
```sh
docker cp curated.csv traccar-db:/
```
`docker cp curated.csv traccar-db:/` - open a root mysql shell to the db container
```sh
docker exec -it traccar-db mysql -uroot -pROOTPASSWORD
```
open a root mysql shel to the db container - connect to database
```sh
use traccar-db
```
`docker exec -it traccar-db mysql -uroot -pROOTPASSWORD` - load the data:
```sql
connect to database LOAD DATA LOCAL INFILE 'inn.csv' INTO TABLE tc_positions FIELDS TERMINATED BY ',' (@osmand, @deviceid,@Time,@Latitude,@Longitude,@valid) set protocol=@osmand,deviceid=@deviceid, devicetime=@Time,fixtime=@Time,servertime=@Time,latitude=@Latitude,longitude=@Longitude, valid=@valid;
```
`use traccar-db`
load the data
```
LOAD DATA LOCAL INFILE 'inn.csv' INTO TABLE tc_positions FIELDS TERMINATED BY ',' (@osmand,@deviceid,@Time,@Latitude,@Longitude,@valid) set protocol=@osmand,deviceid=@deviceid,devicetime=@Time,fixtime=@Time,servertime=@Time,latitude=@Latitude,longitude=@Longitude,valid=@valid;
```