Self-hosting requirements and install
Vivotics runs happily on your own server. This is the checklist that takes a fresh box to a working install.
Requirements
- PHP 8.3 (8.2 will not boot it; 8.4+ untested) with extensions: gd, mbstring, bcmath, intl, zip, curl, pdo_mysql, fileinfo, exif, gmp, soap.
- MySQL 8+ or MariaDB 10.6+ (MariaDB recommended; it handles this schema's write patterns better).
- Apache with mod_rewrite or Nginx; HTTPS strongly recommended.
- Ability to run cron (required: automations, reminders, recurring items all depend on it).
Install steps
- Upload the application files (the repository ships its vendor directory, so no composer step is needed on the server).
- Point the web root at the
public/directory. - Create a database and set credentials in
.env(copy.env.example). - Run
php artisan migrateand visit the site: the installer walks you through app URL, admin account and license verification. - Add the cron entry (see Cron jobs).
- Configure SMTP and, if you use support email, IMAP (see Email setup).
After installing
- Set
APP_DEBUG=falsein production. - Cache config for speed:
php artisan config:cache(re-run after any .env change). - Do not run
php artisan route:cacheon this application; run routes uncached. - Back up the database and the
public/user-uploadsdirectory; together they are your entire state.