How do I set up DEV3 Promptly on my server?

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 promptly-v1.0.1.zip and extract it in the File Manager, for example to /home/youruser/, which gives you /home/youruser/promptly. Extracting on the server is much faster than uploading thousands of small files.
3. Point the domain's document root at promptly/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 promptly 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, Promptly 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 agency "Brightpath Media" and other workspaces with months of writing, document chats, chatbot conversations, leads and invoices) or Empty (the 50 writer templates, the prompt library and the four DEV3 AI models, with no workspaces). The web installer seeds about 35% of the demo history so it fits shared-hosting request limits; the command-line installer below seeds the full set.
4. Admin account: your name, email and a password of at least 8 characters. This account gets the super-admin role.
5. Finish: the installer writes storage/app/installed.lock, links the storage folder and links you to the website, the workspace app at /app and the super-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: emails, invoice links, the widget script and payment return URLs are built from it.

Install on a VPS or with Docker

• VPS: install PHP-FPM, the extensions and a database, extract the zip into a folder such as /var/www so the app is at /var/www/promptly, 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 promptly/public.
• Streaming on Nginx: add fastcgi_buffering off; to the PHP location (Promptly already sends X-Accel-Buffering: no), so answers appear word by word instead of all at once. Behind a proxy or a CDN, turn off response buffering for /app/stream/* and /demo/stream.
• 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/promptly
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.