Assume that your server already meets MetaFox System Requirements. 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:
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. Then, extract the /path/to/metafox/upload.zip file you will see the following source structure under the upload folder
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 are using webserver Apache2, rename the htaccess.example to .htaccess
You will need to grant the write permission on the following folders:
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:
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/
Follow installation steps and input all required info in the Installation Wizard to complete the installation:
Applications: If you have purchased apps on the Appstore, such as ChatPlus, etc. you can select those apps to install at this step
After all info is given properly, you can proceed the last step to install MetaFox site.
Done: When installation is completed successfully, you will see this screen
After the installation is completed, you should remove the public/install folder to avoid security risks. |
Many features require cron to work. Please configure 2 following crons running every minute. You can get the cron command in AdminCP > Settings > Schedule page
php path_to_webroot/artisan schedule:run |
php path_to_webroot/artisan queue:work --stop-when-empty |