INSTALL.md

Development Setup

1. Install VirtualBox and Vagrant

2. Clone and run Cognac Box, a full-featured development environment for php

   git clone https://github.com/reddingwebpro/cognacbox.git ogn-ddb
   cd ogn-ddb
   vagrant up
   

3. Clone ogn-ddb repository into the webroot of the Cognac Box

   rm ./public/index.php
   git clone https://github.com/glidernet/ogn-ddb public
   vagrant ssh
   # The following commands get executed in the vm
   cd /var/www/public
   composer update
   cp sql.php.dist sql.php
   mysql -uroot -proot --database cognacbox < database_schema.sql
   

4. Access your local ogn-ddb instance at 192.168.33.10

5. (optional, for email debugging) Configure MailHog, accessible at 192.168.33.10

   MailHog is installed by default on CognacBox.

   Update /etc/php/8.2/apache2/php.ini by adding the follwoing line:

   sendmail_path = /home/vagrant/go/bin/mhsendmail
   

   Then restart apache to take it into account:

   sudo service apache2 restart