Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Assume that your server already meets MetaFox System RequirementsWe assume that you have done all preparation steps for Installation with either Docker or LAMP server. In this article, we will walk you through the steps to properly install MetaFox on a normal server (Apache2, PHP, and MySQL).

In general, installing MetaFox includes following steps:

  1. Upload MetaFox source on your server
  2. Configure proper permissions of folders
  3. Create database and database user
  4. Proceed installation
  5. Set up cron

Upload MetaFox source on your server

You can download the zip file of the latest MetaFox version in Client Area and extract it on your local machine at /path/to/metafox folder.

Image Removed

Then, extract the /path/to/metafox/upload.zip file you will see the following source structure under the upload folder

Image Removed

Then, upload ALL folders and files under the upload folder to the webroot folder of webserver. Normally, the webroot folder of your server usually has name public_html. 

  • If you aren't sure where is the webroot folder, you should ask your hosting provider or system administrator.
  • To avoid unexpected issues when uploading source files onto the server, it is highly recommended to upload the zip file on your server and then extract source files to the webroot folder.

If you are using webserver Apache2, rename the htaccess.example to .htaccess

Configure proper permissions of folders

You will need to grant the write permission on the following folders:

  • storage/* (recursively)
  • public/* (recursively)
  • bootstrap/cache/* (recursively)
  • config/* (recursively)

Create database and database user

Create database and database user for MetaFox site. All web hostings support tools to create database and database user quickly. MetaFox supports both Postgres (recommended) and MySQL.

You should grant full permissions on the database for database user. You need to note the following details when completing this step:

  • Database Host (if database is on the same server, the host will be localhost)
  • Database Name
  • Database User
  • Password
  • Port (default 3306 for MySQL and 5432 for Postgres)

...

MetaFox 

Proceed installation with MetaFox Installation Wizard

Assume that your webserver has been set up with the domain yourdomain.com. You can visit the Installation Wizard at the link: https://yourdomain.com/install/ 

...