https://github.com/jeffresc/deltrack
Easily track packages from multiple couriers from a secure, centralized location
https://github.com/jeffresc/deltrack
courier delivery dhl fedex mail package tracking ups usps
Last synced: 22 days ago
JSON representation
Easily track packages from multiple couriers from a secure, centralized location
- Host: GitHub
- URL: https://github.com/jeffresc/deltrack
- Owner: JeffResc
- Archived: true
- Created: 2021-11-17T19:39:11.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-08-06T05:34:37.000Z (about 2 years ago)
- Last Synced: 2025-06-13T09:07:42.694Z (4 months ago)
- Topics: courier, delivery, dhl, fedex, mail, package, tracking, ups, usps
- Language: EJS
- Homepage:
- Size: 1.31 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# DelTrack
DelTrack is an all-in-one delivery tracking solution supporting 24 couriers ([USPS, UPS, FedEx, DHL, etc.](https://github.com/egg-/delivery-tracker#courier-list)) and counting! Notifications can be setup for an email when a package has an exception or has not had a new tracking event in 24 hours.
## Features
- Track unlimited packages from a centralized location
- Store package information in MongoDB for easy reference at a later date
- Local user authentication and registration (registration can be disabled after setting up initial account(s))
- Live scanner using camera or uploaded files to easily add deliveries from the tracking label barcode
## Screenshots
Home
Delivery Details
Live Scanner
Login Page
## Setup
### .env File
Create a .env file at the root directory where `docker-compose.yml` is and set the following environment variables:
| Variable | Description |
|----------------------------|-------------------------------------------------------------------------------------------------------------------------------|
| **MONGO_STRING** | Your MongoDB URI String. Should be something similar to: "mongodb://deltrack:deltrack@mongo:27017/deltrack?authSource=admin". |
| **SESSION_SECRET** | A random session secret string. |
| EMAIL_SERVER_NAME | The SMTP server's name. Usually it's FQDN. |
| EMAIL_HOST | The host IP/domain of the SMTP server. |
| EMAIL_USER | The username of the email user. Usually the user's email address/ |
| EMAIL_PASS | The password of the email user. |
| EMAIL_NAME | The full name of the email user. |
| NOTIFY_EMAIL | The email to send notifications to. |
| **MONGO_INITDB_ROOT_USERNAME** | The initialized MongoDB root username. If using the MONGO_STRING from above, set this to "deltrack". |
| **MONGO_INITDB_ROOT_PASSWORD** | The initialized MongoDB root password. If using the MONGO_STRING from above, set this to "deltrack". |
All variables in **bold** are required. All other variables not in bold can be set in the UI, but will be defaulted to these values on first start.
### Other variables
Set the `REGISTRATION=1` environment variable in the DelTrack container to enable user registration. Set the `REGISTRATION=0` environment variable in the DelTrack container to disable user registration.
### Start docker-compose
Run the following command in the root directory to start DelTrack:
```bash
docker-compose up -d
```