Install Development Environment Windows 10 or later
Here is an instructions how to install a development environment for your local machine.
Install a XAMPP with PHP 8.2.+
Please install a XAMPP with PHP 8.2.+ from address below:
https://www.apachefriends.org/download.html
Important! Laravel 9 and or 10 do not work with PHP 7 and or 8.1.
Before you run composer install command in Windows PowerShell/CMD you need to enable various PHP extension in php.ini file in folder C:\xampp\php.
List of PHP extensions to enable is zip, sodium and gd. Please restart XAMPP Apache 2 after change of php.ini file.
Install a Composer
Please install a composer from address below:
https://getcomposer.org/download/
Install a Node.js LTS
Please install a Node.js LTS from address below:
https://nodejs.org/en/download/
Install a TortoiseGIT
Please install a Tortoise GIT from address below:
https://tortoisegit.org/download/
Install a Git for Windows
Please install a Git for Windows from address below:
Clone a GIT repositories with TortoiseGIT
Clone https://github.com/foghorn-hash/i4ware_SDK.git to C:\xampp\htdocs. See the Screenshots below:
Run a XAMPP as administrator
Important! You must run a XAMPP as administrator or otherwise it not work as needed.
Prepare a Development in XAMPP (a Laravel PHP Back-end of this App)
Before you starting a developing this software is important you make branch.
And then switch/checkout to your new branch.
Run a composer install.
Copy .env-example with filename .env. See the Screenshot below:
Then run a php artisan key:generate. See the Screenshots below:
Create database forge and user forge for it. See the Screenshots below:
Edit .env file. See the Screenshot below.
Or you can use username root and empty password:
Run php artisan migrate and then php artisan db:seed. Username that comes to table users is same then in this setting in .env file APP_DOMAIN_ADMIN_EMAIL=matti.kiviharju@i4ware.fi and password is 12345678.
Install a Laravel Passport with command php artisan passport:install.
Finally run command php artisan storage:link.
Setting up SMTP
In .env file haves settings below:
MAIL_MAILER=smtp
MAIL_HOST=mailhog
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS=null
MAIL_FROM_NAME="${APP_NAME}"
These must be set like this:
MAIL_MAILER=smtp
MAIL_HOST=smtp.dnainternet.net
MAIL_PORT=25
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS=noreply@i4ware.fi
MAIL_FROM_NAME="${APP_NAME}"
SMTP host must be your ISP (Internet Service Provider) public SMTP on basic consumer Internet Connections.
Telia: mail.inet.fi
Kolumbus / Elisa: mail.kolumbus.fi tai smtp.kolumbus.fi
Welho: smtp.welho.com
Saunalahti / Jippii: posti.saunalahti.fi
Bittiguru: smtp.palvelukanava.fi (vain autentikoiden)
Jippii: mail.jippii.fi
Saunalahti: posti.saunalahti.fi
DNA: smtp.dnainternet.net
NIC: smtp.nic.fi
Baana: smtp.pikabaana.net
MB-Net: mail.mbnet.fi
SurfEU: mail.surfeu.fi
SOON: smtp.sooninternet.net
Song Networks: smtp.song.fi
Netsonic: smtp.netsonic.fi
Prepare a ReactJS front-end
It is important you going to do a branch before you going to change a source code.
Run npm install --legacy-peer-deps in login-form folder.
Create a .env.local file for your ReactJS App and edit it.
Make Pusher and OpenAI accounts: https://pusher.com/ and https://platform.openai.com/
Edit files below:
React .env.local
REACT_APP_SERVER_URL=http://localhost/i4ware_SDK/saas-app/public
REACT_APP_SERVER_STORAGE_URL=http://localhost/i4ware_SDK/saas-app/storage
REACT_APP_DEFAULT_LANGUAGE=en
REACT_APP_PUSHER_KEY=
REACT_APP_PUSHER_CLUSTER=Laravel .env
OPENAI_API_KEY=
OPENAI_MAX_TOKENS=1500Run npm start.
All needed steps has done now
If you see a App in your web-browser below then all you need for start to developing our software has done!