Skip to content
Made in Germany · Support via email & WhatsApp
Home › Documentation

Documentation

Step by step: installation, license, management and updates.

1. Requirements

GastroFox runs on almost any standard web hosting with Plesk or cPanel. Minimum requirements:

PHP8.2 or newer (8.3 recommended)
PHP extensionspdo_mysql, mbstring, openssl, curl, zip, gd, fileinfo, sodium, xml, ctype, tokenizer, bcmath
DatabaseMySQL 5.7+ or MariaDB 10.3+ (one empty database with a user)
Disk spaceat least 1 GB free (software approx. 150 MB, the rest for images and backups)
PHP settingsmemory_limit 256M, max_execution_time 300, upload_max_filesize 20M
SSLHTTPS certificate (e.g. free via Let's Encrypt) – required for online payments
Cron job (recommended)* * * * * php /path/to/gastrofox/artisan schedule:run
Tip: In Plesk, set the domain's document root to the public folder. If that is not possible, GastroFox redirects there automatically.

2. Purchase & licence

  1. After purchase you will find your licence key and the download in the customer area.
  2. The licence is valid for one domain and is linked to your domain automatically during installation.
  3. Test installations on localhost, *.test or *.local are allowed in addition.
  4. Change domain: customer area → licence → “Change domain”.
  5. Updates are included for 12 months. Afterwards your shop keeps running unchanged – you can renew updates in the customer area.

3. Installation

  1. Download: download the ZIP in the customer area.
  2. Upload: upload the ZIP to your domain folder in the Plesk or cPanel file manager and extract it there.
  3. Create a database: create a new MySQL database with a user and password in your hosting panel.
  4. Start the wizard: open your domain in the browser – the installation wizard starts automatically.
  5. Licence: enter your licence key.
  6. Database: enter the credentials (host is usually localhost).
  7. Admin account: choose your name, email and password.
  8. Restaurant: choose language, currency, restaurant name and one of the 5 included designs – done.
Installation wizard

Afterwards you log in at your-domain.com/admin-login.

4. First steps

After installation the dashboard shows a getting-started list. Work through it once from top to bottom:

  • Upload your logo and restaurant name (Website → Header)
  • Enter address, phone and email (Settings → Address & delivery)
  • Set opening hours and delivery areas
  • Create your menu – manually or with the AI import
  • Activate payment methods and set up email sending (SMTP)
  • Add imprint and privacy policy (Settings → System)

Simply overwrite the demo content (images, texts, dishes).

5. Dashboard

The dashboard shows everything important at a glance:

  • New orders – handle them directly with “Accept” or ✕
  • Key figures – orders, revenue, average order value and new customers with trends
  • Charts – revenue and orders by day or month
  • Order availability – pause delivery or pickup with a switch
Dashboard

Navigation: the sidebar on the left (collapsible) and the quick search at the top (Ctrl + K) – type e.g. “opening hours” and press Enter. The bell shows new orders.

On your phone a bar at the bottom gives you dashboard, orders, POS and menu.

Admin on a phone

6. Orders

  1. New online orders appear at the top under New orders (with a sound).
  2. Accept → the guest receives a confirmation email.
  3. Change the status: Preparing → Ready → Delivered. The guest sees it on their order page.
  4. Search and filter under All orders.
Orders

8. Import your menu with AI

  1. In the customer area → “AI menu”, upload photos or a PDF of your menu.
  2. The AI detects categories, dishes, sizes and prices. Check, correct (also via chat) and confirm.
  3. You receive a code (valid for 30 days, single use).
  4. In the admin: Menu → “Update menu” → enter the code → check the preview.
  5. Choose Add (existing dishes stay) or Replace and import.
Import menu
A backup is created automatically before every import – “Restore” brings back your previous menu. The first 2 imports are free, each further one costs €6.99.

9. POS, tables & reservations

Plugins: “POS & service” (POS, open orders, end-of-day) and “Tables & QR ordering” are plugins for €19 each. Reservations are always included. “POS & service” contains no TSE and is not a certified cash register (German KassenSichV).
  • POS: choose in-store, delivery or pickup, tap dishes, “Pay”.
  • Tables & QR: create tables with area and seats. Clicking a table opens its QR code (download, print template, regenerate), link, status (occupied, reserved, unavailable) and notes.
  • Open orders: all running table and POS orders.
  • Reservations: calendar or list view, add one with “+ New reservation”.
  • End of day: the day's revenue by hour, category and payment method – save it as a report.
POS

10. Website content

Everything under Website in the sidebar changes your restaurant's home page:

  • Slider: large hero image with title and text
  • Featured: the three benefits below the hero
  • Delivery & pickup, About us, Gallery, Testimonials: texts and images of those sections
  • Order section: offer banner (a price in the title is shown as a sticker automatically)
  • Contact: contact form and map
  • News ticker: the scrolling line at the very top
  • Header & navigation / Footer: logo, menu items, social media, footer
  • Promo code: discount codes (percent or amount, validity, minimum order)
Slider

11. Design & appearance

  1. Settings → Appearance → choose a design template: 5 designs are included, premium designs (€79 each) can be tried free for 30 days. Without a purchase the site switches back to an included design after the trial.
  2. “Apply template colours” sets matching colours, fonts and logo colours. Everything stays editable afterwards.
  3. Below: main colours, fonts, corner radius, container width.
  4. Optional: light/dark switch for guests and – with the accessibility plugin – the accessibility tool.
  5. “Save changes”.
Appearance

12. Settings

Under Settings you find all areas as tiles:

Settings
Opening hoursOpen/closed per day, times and break. No orders are possible outside opening hours.
Address & deliveryRestaurant address, delivery areas by postcode with delivery fee and minimum order, pickup discount.
PaymentActivate payment methods (cash, PayPal, Stripe …) and enter credentials. Plus currency and tax rates.
NotificationsEmail sending (SMTP details from your host), sender, which emails guests and you receive.
LanguagesSwitch languages on/off, default language, translate texts.
SEOPage title, description, social media preview image, Google Analytics.
SystemImprint, privacy policy, cookie notice, maintenance mode.
Staff & permissionsCreate staff accounts. Pick a template (manager, service, kitchen, driver) and adjust each permission – e.g. only view orders or only take payments. License, plugins and user management stay with the owner.
Address and delivery

13. AI ordering chat

Plugin (€39): buy and install the AI ordering chat under Settings → Software updates → Plugins & designs. You need your own OpenAI account.
  1. Settings → AI chatbot → “Enable”.
  2. Enter and validate your OpenAI API key (get it at platform.openai.com).
  3. Choose a model – recommended: gpt-5.4-mini (fast and cheap, a few cents per conversation).
  4. Adjust title, greeting and colour, save.

The chat replies in the guest's language, shows dishes with images, fills the cart and places the order – it appears under Orders as usual.

AI chatbot

14. Plugins & premium designs

Under Settings → Software updates → Plugins & designs you see all extensions with price and status:

  • Buy: click “Buy” – for AI chat, accessibility and POS you confirm the notice first. You pay via Stripe and are taken back automatically; the plugin is installed right away.
  • Try premium designs: “Try for 30 days” installs and activates the design. You get a reminder shortly before it ends; without a purchase the site switches back to an included design.
  • Updates: new plugin versions appear in the same place (“Update”) – during your update period.
  • Invoices: every payment automatically creates an invoice (PDF by email and in the customer area).

You can order a custom design in the customer area with the support ticket “Request a custom design”.

15. Receipt printer

With the receipt printer plugin new orders are printed automatically.

  1. Set up the printer on your PC (USB, Bluetooth or Wi-Fi) and make it the default printer in Windows/macOS.
  2. Admin → Printer → choose paper width (58 or 80 mm), copies and content → save.
  3. Switch on “Use this browser as print station” and make a test print.
  4. For printing without a dialog: start Chrome with --kiosk-printing (instructions on the printer page).

As long as the admin is open on the print station, every new order is printed immediately. Single receipts can be printed any time via “Print receipt”.

16. Ready2Order

Settings → Ready2Order: enter the API key of your ready2order POS and enable it. Online orders are then sent to the POS automatically.

17. Updates, languages & backups

  1. Settings → Software updates → “Check for updates”.
  2. If a new version is available: read the changes → “Install update”.
  3. Everything is backed up automatically first (files + database). If something fails, the previous version is restored.
  4. Under Languages you install additional language packs (e.g. French, Italian, Spanish, Turkish) with one click.
  5. After 12 months you can extend update access in the customer area for €49 per year – your installation keeps running without renewal too.
Software updates
Your own backup: also back up regularly via your hosting (Plesk backup) – files and database.

18. Troubleshooting

White page / error 500Check the PHP version (min. 8.2) and that all extensions are active. The folders storage and bootstrap/cache must be writable.
Licence not recognisedCheck the domain in the customer area (with or without www is the same). After moving: “Change domain”.
Emails do not arriveCheck the SMTP details under Notifications; the sender address must belong to your domain. Check the spam folder.
Orders not possibleCheck opening hours, delivery areas and “Order availability” on the dashboard. At least one payment method must be active.
Images do not uploadIncrease upload_max_filesize in your hosting (e.g. 20M).
Update stopsThe previous version stays active. Try again or open a support ticket.

Need help?

Open a support ticket in the customer area or message us on WhatsApp.

GastroFox assistant● online
Hi! 👋 I answer your questions about GastroFox – pricing, features, setup. What would you like to know?
AI assistant – answers may contain mistakes. Binding information: info@gastrofox.eu