diff --git a/01---Install.md b/01---Install.md index 9b60b86..fbd6019 100644 --- a/01---Install.md +++ b/01---Install.md @@ -4,7 +4,13 @@ If you're using Fipamo on a server to host and serve, it doesn't care what kind Once that is done, grab a copy of the latest [release](https://koodu.h-i.works/projects/fipamo/releases) or clone `git clone https://koodu.h-i.works/projects/fipamo.git your-folder` (replace 'your-folder' with whatever you want) it to make it easier to update. Once you're in there run `php composer.phar install` (or just `composer install` if Composer is installed globally) to install Fipamo's dependencies. -From here, you have a couple of options depending on where Fipamo is installed. If you're using it on your desktop, go into `public/index` and start up PHP's built in web server with `php -S localhost:8000` and then browse to localhost:8000/dashboard to get started with the install. If you're serving it from a web host, just go to yourcoolassdomain/dashboard. +Next, you need to set up a .env file to define your install settings. Don't worry, an example is included to make it easy. Just make a copy of .env.example and rename it to .env, and you're good to go. Default paths have been added, but you can change them to whatever you want. It's your site, right? + +Since Fipamo is built on the mighty Laravel, the last thing the .env file needs is an APP_KEY to secure some internal process. Safety first. There are a couple of ways to do this. Suppose you're setting Fipamo up in a development or staging environment, and you're in debug mode. In that case (look in your fresh .env file for the setting APP_DEBUG. If this is set to true, you're in debug mode), you can go to your base URL (the next section shows you how), and Laravel will give you the option to set it for you. + +If you're in a production environment and debug isn't available, you can run the command `php artisan key:generate` in the Fipamo install directory to set it for you. + +From here, you have a couple of options depending on where Fipamo is installed. If you're using it on your desktop, go into `public/index` and start up PHP's built in web server with `php -S localhost:8000` and then browse to localhost:8000/to get started with the install. If you're serving it from a web host, just go to yourcoolassdomain/. One thing to keep in mind is that Fipamo creates its own backup and they can get pretty big(yeah, it's getting worked on). When restoring a sizeable backup or uploading a sizeable file, it's very possible to get a file is too large error from the system.