How do I install DEV3 Deskly step by step?

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 deskly-v1.0.1.zip and extract it in the File Manager, for example to /home/youruser/deskly. Extracting on the server is much faster than uploading thousands of small files.
3. Point the domain's document root at deskly/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 deskly/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, Deskly 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.
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 company "Orbitly Software" with agents, customers, tickets, articles 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 sends you to the agent panel at /admin. After this, /install is closed.

Keep APP_DEBUG=false in production.

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/deskly, give the web server user write access to storage/ and bootstrap/cache/, and point Nginx or Apache at deskly/public. The Documentation has a complete Nginx server block, including the websocket proxy for Reverb.
• 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/deskly
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.