Quick Start
Travelio — from download to a working install
Developed By: BugBuild Labs
Quick Start
The shortest path from the ZIP you downloaded to a working Travelio install. Every step is covered in more depth in the Web (Admin) documentation.
| Step | What you do | Roughly |
|---|---|---|
| 1 | Create the database | 2 min |
| 2 | Upload the files and point the domain at /public | 5 min |
| 3 | Fill in .env | 3 min |
| 4 | Run the installer commands | 3 min |
| 5 | Log in and change the demo passwords | 2 min |
| 6 | Point the mobile app at your API and run it | 5 min |
Prefer a browser? After step 2 (and a database from step 1), open https://yourdomain.com/install instead of doing steps 3–4 by hand: the guided installer checks PHP version, extensions and writable folders, tests the database connection, writes .env, migrates and seeds, and creates your own super-admin account. Then continue at step 5 and run php artisan storage:link once.
If you only want to look around first, install with the demo data (--seed) — it fills the system with sample packages, bookings, customers and website content you can delete later.
1. Create the Database
In cPanel → MySQL Databases: create a database, create a user with a strong
password, then add the user to the database with ALL PRIVILEGES. Use
utf8mb4_unicode_ci collation.
cPanel prefixes names with your account, so travelio_db becomes something like myaccount_travelio_db. Use the full prefixed name in .env.
2. Upload the Files
Extract Main_Files.zip and upload the contents of WebSourceCode/ to
your server. Point the domain's document root at the public/ folder.
Make these writable (755, or 775 if PHP runs as another user):
storage/
bootstrap/cache/Requirements: PHP 8.3+ with the pdo_mysql, mbstring, openssl, tokenizer, xml, curl, fileinfo, bcmath, json extensions (and zip if you will use System Update), MySQL 8 / MariaDB 10.6+, Composer 2.
3. Configure .env
Copy .env.example to .env and set at least these:
APP_NAME="Travelio"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://yourdomain.com
APP_TIMEZONE=Asia/Dhaka
DB_DATABASE=myaccount_travelio_db
DB_USERNAME=myaccount_dbuser
DB_PASSWORD=your_passwordThat is all .env needs. Mail, payment gateways, social login, push, WhatsApp and the rest are entered later in the admin panel
(see the .env reference).
4. Install
composer install --no-dev --optimize-autoloader
php artisan key:generate
php artisan migrate --seed
php artisan optimizeThat builds every table and seeds roles, permissions, settings and demo data. It does not need a queue worker; add the scheduler cron later (Common Setup).
No SSH access (shared cPanel)? You do not need it: run composer install once on your own computer, upload the result, and let the browser installer at /install do the rest. Step by step: Install on cPanel (no terminal).
5. Log In
Open https://yourdomain.com/login.
| Role | Password | |
|---|---|---|
| Super Admin | [email protected] | 12345678 |
| Admin | [email protected] | 12345678 |
| Travel Agent | [email protected] | 12345678 |
| Customer | [email protected] | 12345678 |
Change every one of these passwords immediately and delete the accounts you do not need. They are public knowledge — they are printed in this documentation.
Then set your agency name, logo, currency and timezone under Settings → General, and your SMTP details under Settings → Mail — customers receive their sign-up verification code by email, so mail must work before the app is opened to the public.
6. Run the Mobile App
Open AppSourceCode/ — one Flutter project for customers, agents and guides — put your
server in env/prod.json and run it:
// env/prod.json
{ "API_HOST": "https://yourdomain.com", "APP_API_KEY": "travelio-app-key-7c2e9a4d1f8b6035" }
flutter pub get
flutter run --dart-define-from-file=env/prod.jsonThe key shown is the one a fresh backend seeds under Settings → API Security, so a new install and the stock app work together. If you generate a new key there, put it here and rebuild. Full detail: Common Setup, Travelio App.
What Next
- CMS — replace the demo pages, sliders, blogs and testimonials with your own.
- Tour Management — add your real packages and departures.
- Users & Roles — create accounts for your staff with the right permissions.
- Payment gateways — add your bank accounts for verified bank transfers, and bKash, SSLCOMMERZ, JazzCash or Easypaisa for online payment.
- Multi-vendor marketplace — on for a fresh install (off after an upgrade); switch it on or off in Settings → General → Marketplace to let outside hotels, operators and transport providers sell through your site.
- Common Setup — mail, social login, push, WhatsApp, SMS, flight API (Amadeus, Sabre, Travelport, Duffel, TBO, Kiwi) and AI keys, loyalty and booking policy, scheduler, backups (take your own database backup), the developer API reference and the go-live checklist.