1. Notes before installation<\/h2>\n\n\n\n
These are the changes of Magento 2.4.7 compared to previous versions. We need to know these before installation.<\/p>\n\n\n\n
- \n
- Compatible PHP 8.3.<\/li>\n\n\n\n
- Compatible Elasticsearch 8.11.<\/li>\n\n\n\n
- Supports Varnish 7.4.<\/li>\n\n\n\n
- Supports Redix 7.2.<\/li>\n\n\n\n
- Supports RabbitMQ 3.13.<\/li>\n\n\n\n
- Compatible with Composer 2.7.x.<\/li>\n<\/ul>\n\n\n\n
2. Install and Configure Apache<\/h2>\n\n\n\n
You can refer to the post How To Install Apache On Ubuntu 20.04<\/a><\/strong> to be able to install Apache 2.<\/p>\n\n\n\n
3. Install MySQL<\/h2>\n\n\n\n
Install MySQL using apt command:<\/p>\n\n\n
\nsudo apt install mysql-server\n<\/pre><\/div>\n\n\n
When prompted, typing
Y<\/code> to confirm installation and then pressENTER<\/code>.<\/p>\n\n\n\nWhen the installation is complete, run the following command to secure your MySQL. This command will remove some insecure default settings and block access to your database system.<\/p>\n\n\n
\nsudo mysql_secure_installation\n<\/pre><\/div>\n\n\n
When prompted, press
Y<\/code> to setup validate password.<\/p>\n\n\n\nNext, select a level of password validation. Enter your root password. The server will show the password strength for the root password you just entered and the server will ask if you want to continue with that password. If you accept, press
Y<\/code>.<\/p>\n\n\n\nFor the rest of the questions, press
Y<\/code> and pressENTER<\/code> key at each prompt.<\/p>\n\n\n\nWhen finished, Test login to MySQL with root user by the command:<\/p>\n\n\n
\nsudo mysql\n<\/pre><\/div>\n\n\n
You should see output like this:<\/p>\n\n\n
\nWelcome to the MySQL monitor. Commands end with ; or \\g.\nYour MySQL connection id is 807\nServer version: 8.0.23-0ubuntu0.20.04.1 (Ubuntu)\n \nCopyright (c) 2000, 2021, Oracle and\/or its affiliates.\n \nOracle is a registered trademark of Oracle Corporation and\/or its\naffiliates. Other names may be trademarks of their respective\nowners.\n \nType 'help;' or '\\h' for help. Type '\\c' to clear the current input statement.\n \nmysql> \n<\/pre><\/div>\n\n\n
![\"MySQL](\"https:\/\/i0.wp.com\/www.magetop.com\/blog\/wp-content\/uploads\/2021\/05\/Anh-man-hinh-2025-02-11-luc-09.52.45.png?resize=800%2C526&ssl=1\")
<\/figure>\n\n\n\nThen, exit MySQL console by command:<\/p>\n\n\n
\nexit\n<\/pre><\/div>\n\n\n
You can install phpmyadmin to easily manage the database with this post\u00a0How To Install PhpMyAdmin On Ubuntu<\/a><\/strong>.<\/p>\n\n\n\n
Configure Password Access for the MySQL Root Account<\/strong><\/p>\n\n\n\n
Login with root user.<\/p>\n\n\n
\nsudo mysql\n<\/pre><\/div>\n\n
\nSELECT user,authentication_string,plugin,host FROM mysql.user;\n<\/pre><\/div>\n\n\n
Note: Replace \u2018 your_secure_password<\/code>\u2018 with your password.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\nALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_secure_password';\n<\/pre><\/div>\n\n\n
Verify mysql.user table with the command:<\/p>\n\n\n
\nSELECT user,authentication_string,plugin,host FROM mysql.user;\n<\/pre><\/div>\n\n
\nexit\n<\/pre><\/div>\n\n\n
Create new MySQL user for Magento 2<\/strong><\/p>\n\n\n\n
Login with root user.<\/p>\n\n\n
\nmysql -u root -p\n<\/pre><\/div>\n\n
\nSELECT user,authentication_string,plugin,host FROM mysql.user;\n<\/pre><\/div>\n\n\n
Note: Replace \u2018 your_secure_password<\/code>\u2018 with your password.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\nCREATE USER 'magento2'@'localhost' IDENTIFIED BY 'your_secure_password';\n<\/pre><\/div>\n\n
\nALTER USER 'magento2'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_secure_password';\n<\/pre><\/div>\n\n\n
Grant all privileges to
magento2<\/code> users.<\/p>\n\n\n\nGRANT ALL PRIVILEGES ON *.* TO 'magento2'@'localhost' WITH GRANT OPTION;\n<\/pre><\/div>\n\n
\nSELECT user,authentication_string,plugin,host FROM mysql.user;\n<\/pre><\/div>\n\n
\nexit\n<\/pre><\/div>\n\n\n
Create Magento 2 database<\/strong><\/p>\n\n\n
\nmysql -u magento2 -p\n<\/pre><\/div>\n\n
\nCREATE DATABASE magento2;\n<\/pre><\/div>\n\n
\nexit\n<\/pre><\/div>\n\n\n
4. Install PHP 8.3<\/h2>\n\n\n\n
First, install all the necessary dependencies:<\/p>\n\n\n
\nsudo apt install curl gpg gnupg2 software-properties-common ca-certificates apt-transport-https lsb-release\n<\/pre><\/div>\n\n\n
Add PHP repository to your system:<\/p>\n\n\n
\nsudo add-apt-repository ppa:ondrej\/php\n<\/pre><\/div>\n\n\n
Update your APT repositories.<\/p>\n\n\n
\nsudo apt update\n<\/pre><\/div>\n\n\n
Install PHP 8.3 with command:<\/p>\n\n\n
\nsudo apt install php8.3\n<\/pre><\/div>\n\n\n
And packages:<\/p>\n\n\n
\nsudo apt install php8.3-{exif,bz2,intl,soap,cli,pdo,mysql,zip,gd,mbstring,curl,xml,bcmath,common,xmlrpc,gmp}\n<\/pre><\/div>\n\n\nNext, verify your PHP version:<\/p>\n\n\n
\nphp -v\n<\/pre><\/div>\n\n\n
You should see output like this:<\/p>\n\n\n
\nPHP 8.3.16 (cli) (built: Jan 19 2025 13:45:36) (NTS)\nCopyright (c) The PHP Group\nZend Engine v4.3.16, Copyright (c) Zend Technologies\n with Zend OPcache v8.3.16, Copyright (c), by Zend Technologies\n<\/pre><\/div>\n\n\n
![\"Check](\"https:\/\/i0.wp.com\/www.magetop.com\/blog\/wp-content\/uploads\/2021\/05\/Anh-man-hinh-2025-02-11-luc-10.17.57.png?resize=800%2C529&ssl=1\")
<\/figure>\n\n\n\nEdit the \/etc\/apache2\/mods-enabled\/dir.conf file.<\/p>\n\n\n
\nsudo nano \/etc\/apache2\/mods-enabled\/dir.conf\n<\/pre><\/div>\n\n\n
Modify the index.php file order to the top listed in the DirectoryIndex.<\/p>\n\n\n\n
The dir.conf file after modifying will look like this:<\/p>\n\n\n
\n<IfModule mod_dir.c>\n DirectoryIndex index.php index.html index.cgi index.pl index.xhtml index.htm\n<\/IfModule>\n \n# vim: syntax=apache ts=4 sw=4 sts=4 sr noet\n<\/pre><\/div>\n\n\n
Enable
mbstring<\/code> extension.<\/p>\n\n\n\nsudo phpenmod mbstring\n<\/pre><\/div>\n\n\n
Enable the Apache rewrite module.<\/p>\n\n\n
\nsudo a2enmod rewrite\n<\/pre><\/div>\n\n\n
Reload Apache for the changes to take effect.<\/p>\n\n\n
\nsudo systemctl reload apache2\n<\/pre><\/div>\n\n\n
5. Install Elasticsearch<\/h2>\n\n\n\n
Before installing Elasticsearch, we need install necessary packages.<\/p>\n\n\n
\nsudo apt install dirmngr ca-certificates software-properties-common apt-transport-https lsb-core curl wget -y\n<\/pre><\/div>\n\n\n
Install Elasticsearch.<\/p>\n\n\n
\nwget -q https:\/\/artifacts.elastic.co\/GPG-KEY-elasticsearch -O- | sudo gpg --dearmor -o \/usr\/share\/keyrings\/elasticsearch-keyring.gpg\n<\/pre><\/div>\n\n
\necho "deb [signed-by=\/usr\/share\/keyrings\/elasticsearch-keyring.gpg] https:\/\/artifacts.elastic.co\/packages\/8.x\/apt stable main" | sudo tee \/etc\/apt\/sources.list.d\/elastic-8.x.list\n<\/pre><\/div>\n\n
\nsudo apt update\n<\/pre><\/div>\n\n
\nsudo apt-get install elasticsearch=8.11.0\n<\/pre><\/div>\n\n\n
Configure Elasticsearch<\/strong><\/p>\n\n\n\n
To configure Elasticsearch, we will edit its main configuration file
elasticsearch.yml<\/code><\/p>\n\n\n\nsudo nano \/etc\/elasticsearch\/elasticsearch.yml\n<\/pre><\/div>\n\n\n
Find the line that specifies
network.host<\/code> andhttp.port<\/code>, uncomment it, and replace its value like this:<\/p>\n\n\n\n# ---------------------------------- Network -----------------------------------\n#\n# By default Elasticsearch is only accessible on localhost. Set a different\n# address here to expose this node on the network:\n#\nnetwork.host: localhost\n#\n# By default Elasticsearch listens for HTTP traffic on the first free port it\n# finds starting at 9200. Set a specific HTTP port here:\n#\nhttp.port: 9200\n#\n# For more information, consult the network module documentation.\n#\n<\/pre><\/div>\n\n\n
Run the commands below to secure Elasticsearch<\/p>\n\n\n
\nsudo ufw allow from anywhere to any port 9200 \n<\/pre><\/div>\n\n
\nsudo ufw enable \n<\/pre><\/div>\n\n
\nsudo ufw status \n<\/pre><\/div>\n\n
\nsudo systemctl status elasticsearch\n<\/pre><\/div>\n\n\n
Start and enable Elasticsearch.<\/p>\n\n\n
\nsudo systemctl start elasticsearch\n<\/pre><\/div>\n\n
\nsudo systemctl enable elasticsearch\n<\/pre><\/div>\n\n\n
Verify Elasticsearch proxy with port 9200 by command:<\/p>\n\n\n
\ncurl -X GET 'http:\/\/localhost:9200'\n<\/pre><\/div>\n\n\n
If the installation is successful you will receive a response similar below:<\/p>\n\n\n
\n{\n "name" : "ubuntu",\n "cluster_name" : "elasticsearch",\n "cluster_uuid" : "3UwkdtxPTiaFR5z2iDdq8A",\n "version" : {\n "number" : "8.11.0",\n "build_flavor" : "default",\n "build_type" : "deb",\n "build_hash" : "d9ec3fa628c7b0ba3d25692e277ba26814820b20",\n "build_date" : "2023-11-04T10:04:57.184859352Z",\n "build_snapshot" : false,\n "lucene_version" : "9.8.0",\n "minimum_wire_compatibility_version" : "7.17.0",\n "minimum_index_compatibility_version" : "7.0.0"\n },\n "tagline" : "You Know, for Search"\n}\n<\/pre><\/div>\n\n\n![\"Elasticsearch](\"https:\/\/i0.wp.com\/www.magetop.com\/blog\/wp-content\/uploads\/2021\/05\/Anh-man-hinh-2025-02-11-luc-11.18.54.png?resize=800%2C527&ssl=1\")
<\/figure>\n\n\n\nIf the response has the error below:<\/p>\n\n\n
\ncurl: (52) Empty reply from server\n<\/pre><\/div>\n\n\n
Edit its main configuration file
elasticsearch.yml<\/code> and find the line that specifiesxpack.security.enabled<\/code> and replace tofalse<\/code>:<\/p>\n\n\n\n# Enable security features\nxpack.security.enabled: false\n<\/pre><\/div>\n\n\n
6. Install Composer 2<\/h2>\n\n\n\n
Move back to the root directory.<\/p>\n\n\n
\ncd ~\n<\/pre><\/div>\n\n\n
Downloading and installing composer.<\/p>\n\n\n
\ncurl -sS https:\/\/getcomposer.org\/installer -o composer-setup.php\n<\/pre><\/div>\n\n
\nsudo php composer-setup.php --install-dir=\/usr\/bin --filename=composer\n<\/pre><\/div>\n\n\n
You should see output like this:<\/p>\n\n\n
\nAll settings correct for using Composer\nDownloading...\n \nComposer (version 2.8.5) successfully installed to: \/usr\/bin\/composer\nUse it: php \/usr\/bin\/composer\n<\/pre><\/div>\n\n\n
If your installation version is greater than Magento’s requirement, use this command to downgrade the version:<\/p>\n\n\n
\n sudo composer self-update <--your-version-required-->\n<\/pre><\/div>\n\n\n
Check Composer 2 is installed in Ubuntu?<\/p>\n\n\n
\ncomposer\n<\/pre><\/div>\n\n\n
If installed, you should see output like this:<\/p>\n\n\n
\n ______\n \/ ____\/___ ____ ___ ____ ____ ________ _____\n \/ \/ \/ __ \\\/ __ `__ \\\/ __ \\\/ __ \\\/ ___\/ _ \\\/ ___\/\n\/ \/___\/ \/_\/ \/ \/ \/ \/ \/ \/ \/_\/ \/ \/_\/ (__ ) __\/ \/\n\\____\/\\____\/_\/ \/_\/ \/_\/ .___\/\\____\/____\/\\___\/_\/\n \/_\/\nComposer version 2.7.9 2024-09-04 14:43:28\n\nUsage:\n command [options] [arguments]\n\n\nUsage:\n command [options] [arguments]\n \nOptions:\n -h, --help Display this help message\n -q, --quiet Do not output any message\n -V, --version Display this application version\n --ansi Force ANSI output\n --no-ansi Disable ANSI output\n...\n<\/pre><\/div>\n\n\n
![\"Install](\"https:\/\/i0.wp.com\/www.magetop.com\/blog\/wp-content\/uploads\/2021\/05\/Anh-man-hinh-2025-02-11-luc-12.28.04.png?resize=800%2C528&ssl=1\")
<\/figure>\n\n\n\n7. Download Magento 2.4.7<\/h2>\n\n\n\n
Go to
html<\/code> folder by command:<\/p>\n\n\n\ncd \/var\/www\/html\n<\/pre><\/div>\n\n\n
Create a new Composer project using the Magento Open Source or Magento Commerce metapackage.<\/p>\n\n\n\n
Magento Open Source<\/strong><\/p>\n\n\n
\ncomposer create-project --repository-url=https:\/\/repo.magento.com\/ magento\/project-community-edition <install-directory-name>\n<\/pre><\/div>\n\n\n
For example:<\/p>\n\n\n
\ncomposer create-project --repository-url=https:\/\/repo.magento.com\/ magento\/project-community-edition magento2\n<\/pre><\/div>\n\n\n
Download Magento 2 with the specified version.<\/p>\n\n\n
\ncomposer create-project --repository-url=https:\/\/repo.magento.com\/ magento\/project-community-edition=<magento-version> <install-directory-name>\n<\/pre><\/div>\n\n\n
For example:<\/p>\n\n\n
\ncomposer create-project --repository-url=https:\/\/repo.magento.com\/ magento\/project-community-edition=2.4.7 magento2\n<\/pre><\/div>\n\n\n
Magento Commerce<\/strong><\/p>\n\n\n
\ncomposer create-project --repository-url=https:\/\/repo.magento.com\/ magento\/project-enterprise-edition <install-directory-name>\n<\/pre><\/div>\n\n\n
Download Magento 2 with the specified version.<\/p>\n\n\n
\ncomposer create-project --repository-url=https:\/\/repo.magento.com\/ magento\/project-enterprise-edition=<magento-version> <install-directory-name>\n<\/pre><\/div>\n\n\n
Set file permissions<\/strong><\/p>\n\n\n
\ncd \/var\/www\/html\/<magento install directory>\nfind var generated vendor pub\/static pub\/media app\/etc -type f -exec chmod g+w {} +\nfind var generated vendor pub\/static pub\/media app\/etc -type d -exec chmod g+ws {} +\nchown -R :www-data .\nchmod u+x bin\/magento\nsudo chmod -R 777 var\/ pub\/static generated\/ app\/etc pub\/media\n<\/pre><\/div>\n\n\n8. Install Magento 2.4.7<\/h2>\n\n\n\n
Go to Magento 2 install directory.<\/p>\n\n\n
\ncd \/var\/www\/html\/<magento install directory>\n<\/pre><\/div>\n\n\n
You must use the command line to install Magento.<\/p>\n\n\n
\nphp bin\/magento setup:install \\\n--base-url=<your-domain> \\\n--db-host=localhost \\\n--db-name=magento2 \\\n--db-user=magento2 \\\n--db-password=<your-db-password-of-magento2-user> \\\n--admin-firstname=Admin \\\n--admin-lastname=Admin \\\n--admin-email=admin@admin.com \\\n--admin-user=admin \\\n--admin-password=<your-admin-password> \\\n--language=en_US \\\n--currency=USD \\\n--timezone=America\/Chicago \\\n--use-rewrites=1\n<\/pre><\/div>\n\n\n
![\"Run](\"https:\/\/i0.wp.com\/www.magetop.com\/blog\/wp-content\/uploads\/2021\/05\/Anh-man-hinh-2025-02-11-luc-11.35.27.png?resize=800%2C526&ssl=1\")
<\/figure>\n\n\n\nWait until the installation is successful.<\/p>\n\n\n\n
9. Change DocumentRoot To Pub<\/h2>\n\n\n\n
You can read detailed documentation from Magento here<\/a>.<\/p>\n\n\n\n
If you append a directory name to your server\u2019s hostname or IP address to create the base URL when you installed Magento (for example http:\/\/<your-ip>\/magento2 or http:\/\/<your-sever-hostname>\/magento2), you\u2019ll need to remove it.<\/p>\n\n\n\n
Edit your virtual host file<\/strong><\/p>\n\n\n
\nsudo nano \/etc\/apache2\/sites-available\/000-default.conf\n<\/pre><\/div>\n\n\n
Add the path to your Magento
pub\/<\/code> directory to theDocumentRoot<\/code> directive:<\/p>\n\n\n\n<VirtualHost *:80>\n \n ServerAdmin webmaster@localhost\n DocumentRoot \/var\/www\/html\/magento2\/pub\n \n ErrorLog ${APACHE_LOG_DIR}\/error.log\n CustomLog ${APACHE_LOG_DIR}\/access.log combined\n \n <Directory "\/var\/www\/html">\n AllowOverride all\n <\/Directory>\n<\/VirtualHost>\n<\/pre><\/div>\n\n\nRestart Apache for the changes to take effect:<\/p>\n\n\n
\nsudo systemctl restart apache2\n<\/pre><\/div>\n\n\n
Update your base URL<\/strong><\/p>\n\n\n\n
Login with magento2 user.<\/p>\n\n\n
\nmysql -u magento2 -p\n<\/pre><\/div>\n\n\n
Specify the Magento database you created when you installed Magento:<\/p>\n\n\n
\nuse magento2\n<\/pre><\/div>\n\n\n
Update the base URL:<\/p>\n\n\n\n
For IP:<\/p>\n\n\n
\nUPDATE core_config_data SET value='http:\/\/<your-ip>' WHERE path='web\/unsecure\/base_url';\n<\/pre><\/div>\n\n\n
For Server\u2019s Hostname:<\/p>\n\n\n
\nUPDATE core_config_data SET value='http:\/\/<your-server-hostname>' WHERE path='web\/unsecure\/base_url';\n<\/pre><\/div>\n\n\n
Update the env.php file<\/strong><\/p>\n\n\n\n
Go to env.php file.<\/p>\n\n\n
\nsudo nano \/var\/www\/html\/magento2\/app\/etc\/env.php\n<\/pre><\/div>\n\n\n
The node below needs to be in the file, check it out:<\/p>\n\n\n
\n'directories' => [\n 'document_root_is_pub' => true\n]\n<\/pre><\/div>\n\n\n
Switch modes<\/strong><\/p>\n\n\n\n
Go to Magento 2 install directory.<\/p>\n\n\n
\ncd \/var\/www\/html\/magento2\n<\/pre><\/div>\n\n\n
Switch to
production<\/code> mode.<\/p>\n\n\n\nphp bin\/magento deploy:mode:set production\n<\/pre><\/div>\n\n
\nphp bin\/magento cache:flush\n<\/pre><\/div>\n\n\n
Refresh your browser and verify that the storefront displays properly.<\/p>\n\n\n\n
Switch to
developer<\/code> mode.<\/p>\n\n\n\nphp bin\/magento deploy:mode:set developer\n<\/pre><\/div>\n\n
\nphp bin\/magento cache:flush\n<\/pre><\/div>\n\n\n
Refresh your browser and verify that the storefront displays properly.<\/p>\n\n\n\n
Verify the storefront<\/strong><\/p>\n\n\n\n
If you see the storefront showing a 500 internal server error, please fix set permissions for the Magento 2 file according to the post: How To Fix Magento 2 500 Internal Server Error<\/a><\/strong>.<\/p>\n\n\n\n
10. Grant Permission To Folders<\/h2>\n\n\n
\nchmod -R 777 var\n<\/pre><\/div>\n\n
\nchmod -R 777 pub\/static\n<\/pre><\/div>\n\n