DEV3 Technologies home

DEV3 Developer Forum

How do I install DEV3 Vendora step by step?

Product questionsSolved0 views

1 reply

dev3 · Accepted answer

Install on shared hosting (cPanel, Plesk)

  1. Create a MySQL database and user and give the user all privileges, or skip this and choose SQLite in the wizard.
  2. Upload vendora-v1.0.2.zip and extract it in the File Manager, for example to /home/youruser/vendora. Extracting on the server is much faster than uploading thousands of small files.
  3. Point the domain's document root at vendora/public. Never serve the app folder itself. If your host won't let you change the document root, move the contents of public/ into public_html and edit the two paths in public_html/index.php so they point at the vendora folder.
  4. Choose PHP 8.2 or newer in MultiPHP Manager or Select PHP Version and enable the extensions above.
  5. Open https://your-domain/install and follow the wizard.
  6. Add the cron entry (see Cron and queue below).

The installation wizard

On the first visit every page redirects to /install. If .env is missing, Vendora creates it from .env.example and generates an APP_KEY.

  1. Requirements: PHP version, extensions, a PDO driver, writable folders and the .env file. Fix any red items and reload; you can't continue until everything passes.
  2. Database: MySQL / MariaDB (host, port, database, username, password) or SQLite. The connection is tested before .env is written, and APP_URL is saved too.
  3. Data: Demo data (the fictional "Vendora Market" with shops, products, customers, months of orders, reviews, refunds and payouts) or Empty (roles, tax classes, a worldwide shipping zone and the starter legal and help pages, but no shops or products).
  4. Admin account: your name, email and a password of at least 8 characters. This account gets the marketplace admin role.
  5. Finish: the installer writes storage/app/installed.lock, links the storage folder and links you to the storefront, the admin panel at /admin and the seller centre at /vendor. After this, /install is closed.

Keep APP_DEBUG=false in production, and make sure APP_URL is your real https:// address: emails, download links and payment return URLs are built from it.

Install on a VPS or with Docker

  • VPS: install PHP-FPM, the extensions and a database, copy the app to a folder such as /var/www/vendora, give the web server user write access with chown -R www-data storage bootstrap/cache (and to the app folder, so the installer can create .env), and point Nginx or Apache at vendora/public. The Documentation has a complete Nginx server block.
  • Docker: the Documentation shows how to run the app in the official php:8.3-apache image with the document root set to public/. Enable mod_rewrite and the PHP extensions above, then open /install.

Install from the command line

With SSH you can skip the wizard. Set the database and APP_URL in .env first, then run:

cd /var/www/vendora
cp .env.example .env    # skip if .env already exists, then edit DB_* and APP_URL
php artisan key:generate
php artisan dev3:install --demo --admin-email=owner@example.com --admin-password='choose-a-strong-password'

Leave out --demo for an empty install. --admin-name= sets the display name and --force runs it again on an installed app. The command checks the requirements, migrates, seeds, creates the admin and writes the lock file.

0

Your reply

Every post is reviewed by DEV3 before it appears. Usually reviewed within 24 hours.

Markdown supported. Use ``` for code blocks. Images are not allowed.