29 01 Install
Ro edited this page 2 years ago

The Setup

For Blogging

If you're using Fipamo on a server to host and serve, it doesn't care what kind of web server you have. Just make sure the server points to public/index.php and it's all good.

Once that is done, grab a copy of the latest release or clone git clone https://koodu.ubiqueros.com/are0h/Fipamo.git --branch beta 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.

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.

To fix this you have to adjust your upload_max_filesize directive in your php.ini file. Here's pretty good overview of how to make those changes without much fuss.

Up and running? Learn how to use Fipamo.

For Dev Collaboration

To contribute to Fipamo, you're going to need to grab a copy of the develop branch. Do that with git clone https://code.playvicio.us/Are0h/Fipamo.git.

Once you have a copy, follow the same instructions for the above 'For Blogging' section to get up and running. This branch contains the front end scripting and style pages for the Dashboard.

NGINX Config

server {  
      listen 80;
      server_name yourcoolassdomain.com;
      client_max_body_size 20M //Change to whatever to limit/increase file upload size
      location  / {
            try_files $uri /index.php$is_args$args;
      } 
}

Apache Config

<VirtualHost *:80>
    ServerAdmin admin@yourcoolassdomain.com
    ServerName yourcoolassdomain.com
    ServerAlias www.yourcoolassdomain.com
    DocumentRoot /path-to-fipamo-folder/public
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Also it is strongly recommened to set up a ssl certificate to protect yourself if your using Fipamo through a web server. Certbot makes this process dead simple.

Updating Fipamo

There are two ways to update Fipamo. If you're using git, you can just go into the directory where you set up your site and do a git pull to get the latest. If you're not using git, just grab the latest release and replace your files.

Easy peasy.