Page

Getting started

Install, first settings, sample products, launch order, and update basics.

Recommended setup order

  • Start with Store Settings so the public store name, support email, currency, Site URL, and logo are correct before customers see the store.
  • Next configure Design and Content so the storefront, policy pages, footer links, and site notice match the store.
  • Add products and categories before payment and shipping testing. Checkout testing is easier when the catalog includes a physical product, a digital product, and a product with options or variants.
  • Configure tax, shipping, and payment settings last, then place test orders from the storefront as if you were a customer.

Installing or updating

  • For a new store, upload the release zip, point the web server to the public folder, open install.php, and follow the installer.
  • For an existing store, keep .env, storage, public/uploads, storage/downloads, and the database. Upload the new code over the old code, then open Admin > Production and run the database update.
  • Do not rerun the installer on a live store unless you intentionally want a fresh install. The installed.lock file exists to prevent accidental reinstall.
  • After launch, delete or block public/install.php so nobody can reach the installer directly.

Sample products

  • Sample products are useful when learning because they show physical products, digital downloads, variants, options, images, and sample files.
  • Skip samples for a clean production catalog. Install samples only when you want a demonstration store or training data.
  • If samples were skipped during install, they can be added later from the command line with php bin/seed-sample-catalog.php.