MetaFox Installation
System Requirements
On the Development environment: since we have to build MetaFox Frontend, your server will need to have at least 4G RAM as the Recommendation for React
MetaFox can be installed with docker
or standalone.
Installation with Docker
MetaFox is going to support MySQL and Postgres. For Development environment, we highly recommend using Postgres
The fastest way to install the MetaFox Backend is using docker-compose
. Your server will need to have docker
and docker-compose
installed first. Please refer to Docker Installation Guide.
Installation Steps
Download MetaFox package in Client Area and extract the package on your server. For example, all source files will be uploaded to your server under
home/metafox
folderOpen Terminal and log in SSH to your server. It is necessary to note that you will need to log in with SSH user having permissions to run
docker
Copy the
/home/metafox/backend/.env.example
file to/home/metafox/backend/.env
. There are many environments supported by MetaFox that you may want to take a look. However, we can just use the default configuration at this time.Copy
/home/metafox/backend/.env
to/home/metafox/.env
Run the following commands to start and install MetaFox:
# Configure the owner of source folder to daemonchown -R daemon:daemon /home/metafox# Go to source folder of the backendcd /home/metafox/backend# Start docker-compose containerdocker-compose up -d
After starting successfully, you can check the MetaFox site at http://your_server_IP
or http://your_domain
Standalone Installation
In this section, we are going to guide you to install the MetaFox Backend in the standalone way.
In order for MetaFox to work properly, please check to make sure that your server meets the following software requirements:
- OS: Linux is recommended
- Web server: Apache or NginX
- Database: Postgres or MySQL. Postgres is recommended
- PHP >= 7.4
- PHP Extensions:
ext-curl
ext-dom
ext-json
ext-pdo
ext-zip
sodium
pcov
php-redi
php-imagick
php-memcached
php-pgsql
orphp-mysql
php-ffmpeg
Installation Steps
Download source package in Client Area and extract it to a temporary folder on your server
The MetaFox source includes 2 main folders:
frontend
andbackend
. You can copy all source files underbackend
folder to the web root folder (for example:public_html
) of web server.Go to the web root folder of web server, copy
.env.example
to.env
and update environment variables for:
- Database
- Cache
- Log in SSH to your server with Terminal, then go to the web root folder and run the following command:
./scripts/install.sh
Issues
If you got issues with MetaFox Installation, please open new tickets in Client Area with department of 3rd Party Developer for further support.
References
- Laravel
- Authentication
- Authorization
- Image Processing
- Debug Tool
- Storage System
- Package Management
- Globalization
- Message Queue