DEV3 Technologies home

DEV3 Developer Forum

How do I install DEV3 Learnova step by step?

Product questionsSolved0 views

1 reply

dev3 · Accepted answer

Install on shared hosting (cPanel)

  1. Create a MySQL database and user in MySQL Databases and give the user all privileges, or skip this and choose SQLite in the wizard.
  2. Upload learnova-v1.0.1.zip and extract it in the File Manager, for example to /home/youruser/learnova. Extracting on the server is much faster than uploading thousands of small files.
  3. Point the domain's document root at learnova/public. Never serve the app folder itself. If your host only serves public_html, put the app next to it (not inside) and use an addon domain or subdomain pointed at learnova/public.
  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, Learnova 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 (leave the file blank to use database/database.sqlite). The connection is tested before .env is written, and APP_URL is saved too.
  3. Data: Demo data (the fictional school "Learnova Academy" with instructors, 30+ courses with full curricula, students, months of enrolments, quiz attempts, certificates, payouts and reports) or Empty (roles and default settings only).
  4. Admin account: your name, email and a password of at least 8 characters. This account gets the admin role.
  5. Finish: the installer writes storage/app/installed.lock, links the storage folder and links you to the admin panel at /admin. After this, /install is closed.

Keep APP_DEBUG=false in production, and make sure APP_URL is your real https:// address: certificate verification links and QR codes 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/learnova, give the web server user write access to storage/ and bootstrap/cache/ (and to the app folder, so the installer can create .env), and point Nginx or Apache at learnova/public. The Documentation has a complete Nginx server block, including client_max_body_size for video uploads.
  • Docker: the Documentation includes a Dockerfile and a docker-compose.yml with PHP-FPM, Nginx and MySQL containers. In the wizard's database step, use host db.

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/learnova
cp .env.example .env    # skip if .env already exists, then edit DB_* and APP_URL
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.