PHPackages joanhe/poc-m2-ce-project - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. joanhe/poc-m2-ce-project ActiveProject[Framework](/categories/framework) joanhe/poc-m2-ce-project ======================== eCommerce Platform for Growth (Community Edition) 144 Since Apr 6Pushed 11y ago1 watchersCompare [ Source](https://github.com/joanhe/magento2-community-edition)[ Packagist](https://packagist.org/packages/joanhe/poc-m2-ce-project)[ RSS](/packages/joanhe-poc-m2-ce-project/feed)WikiDiscussions master Synced 3d ago READMEChangelogDependenciesVersions (1)Used By (0) [![Build Status](https://camo.githubusercontent.com/d7704b89933c1e1cb0dbb048776ba01d7131d3fcb2c7c0ef296172012faaf8cc/68747470733a2f2f7472617669732d63692e6f72672f6d6167656e746f2f6d6167656e746f322e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/magento/magento2) Welcome to Magento 2 installation! We're glad you chose to install Magento 2, a cutting edge, feature-rich eCommerce solution that gets results. #### Contents [](#contents) - [Magento 2 system requirements](#magento-2-system-requirements) - [Composer and Magento](#composer-and-magento) - [High-level installation roadmap](#high-level-installation-roadmap) - [Required server permissions](#required-server-permissions) - [Prerequisites](#prerequisites) - [Installing Composer](#installing-composer) - [Cloning the Magento 2 GitHub repository](#cloning-the-magento-2-github-repository) - [Installing or reinstalling the Magento software](#installing-or-reinstalling-the-magento-2-software) - [Verifying the installation](#verifying-the-installation) - [Troubleshooting](#troubleshooting) Magento 2 system requirements ----------------------------- [](#magento-2-system-requirements) Before you install Magento 2, make sure your system meets or exceeds the following requirements: - Operating systems Linux distributions such as RedHat Enterprise Linux (RHEL), CentOS, Ubuntu, Debian, and so on - [Composer](https://getcomposer.org/download/) (latest stable version) - [Apache 2.2](http://httpd.apache.org/download.cgi) or later - PHP 5.4.11 or 5.5.x - Required PHP extensions: - PDO/MySQL - mbstring - mcrypt - mhash - simplexml - curl - gd2, ImageMagick 6.3.7 (or later) or both - soap - [MySQL 5.6.x](http://dev.mysql.com/doc/refman/5.6/en/installing.html) - Mail Transfer Agent (MTA) or an SMTP server - Optional but recommended: - [php\_xdebug2.2.0](http://xdebug.org/download.php) or later (development environments only; can have an adverse effect on performance) - PHPUnit (as a command-line tool) 4.1 or later Composer and Magento -------------------- [](#composer-and-magento) We now use [Composer](https://getcomposer.org/) to install the Magento 2 software. Composer enables us to manage Magento 2, extensions, and their dependencies. Composer provides you with the following advantages: - Enables you to reuse third-party libraries without bundling them with source code - Component-based architecture with robust dependency management - Manages dependencies to reduce extension conflicts and compatibility issues - Versioned dependencies - [Semantic versioning](https://getcomposer.org/doc/01-basic-usage.md#package-versions) - Supports PHP Framework Interoperability standards We'll have more information soon on how developers can use Composer to package extensions to distribute to Magento merchants and to other developers. High-level installation roadmap ------------------------------- [](#high-level-installation-roadmap) Following is a brief overview of how to install the Magento 2 software. ### Step 1: Verify your prerequisites [](#step-1-verify-your-prerequisites) Use the following table to verify you have the correct prerequisites to install the Magento 2 software. Prerequisite How to check For more information Apache 2.2 or later Ubuntu: `apache -v` CentOS: `httpd -v` [Apache](#apache) PHP 5.4.11 or 5.5.x `php -v` [PHP](#php) MySQL 5.6.x `mysql -u [root user name] -p` [MySQL](#mysql) ### Step 2: Prepare to install [](#step-2-prepare-to-install) After verifying your prerequisites, perform the following tasks in order to prepare to install the Magento 2 software. 1. [Installing Composer](#installing-composer) 2. [Cloning the Magento 2 GitHub repository](#cloning-the-magento-2-github-repository) ### Step 3: Install and verify [](#step-3-install-and-verify) 1. [Installing or reinstalling the Magento software](#installing-or-reinstalling-the-magento-2-software) 2. [Verifying the installation](#verifying-the-installation) Required server permissions --------------------------- [](#required-server-permissions) Unless otherwise noted, all commands in this Readme must be entered as a user with `root` privileges and permission to write to the web server docroot. Depending on your system, that might mean you must use different user accounts or add users to the web server user group—provided that group has sufficient privileges. Installing software on Linux typically requires `root` privileges. You should generally not install the Magento 2 software in the web server docroot using `root` privileges; however, that is up to you. Prerequisites ------------- [](#prerequisites) This section discusses how to install software required to install Magento 2. See one of the following sections: - [Before you begin](#before-you-begin) - [Apache](#apache) - [PHP](#php) - [MySQL](#mysql) ### Before you begin [](#before-you-begin) Before you install Magento, you must do all of the following: - Set up one or more hosts that meet the [Magento 2 system requirements](#magento-2-system-requirements). - Make sure you can back up your entire system at various points during the installation so you can roll back in the event of issues. ### Apache [](#apache) #### Installing Apache on Ubuntu [](#installing-apache-on-ubuntu) 1. Install Apache using the guidelines on the [Ubuntu site](https://help.ubuntu.com/10.04/serverguide/httpd.html). 2. Enable server rewrites: - Apache 2.2: Use the guidelines on [askubuntu](http://askubuntu.com/questions/48362/how-to-enable-mod-rewrite-in-apache). - Apache 2.4: Enter the following command: `a2enmod rewrite` 3. Specify the type of directives that can be used in `.htaccess`. Magento uses `.htaccess` for redirects. For guidelines, see: - Apache 2.2: The [Apache 2.2 documentation](http://httpd.apache.org/docs/2.2/mod/core.html#allowoverride). - Apache 2.4: The [Apache 2.4 documentation](http://httpd.apache.org/docs/current/mod/core.html#allowoverride). Note that in Apache 2.4, the server's default site configuration file is `/etc/apache2/sites-available/000-default.conf` For example, you can add the following to the bottom of `000-default.conf`: ``` AllowOverride [value from Apache site] ``` **Note**: You must change the value of `AllowOverride` in the directive for the directory to which you expect to install the Magento software. For example, to install in the web server docroot, edit the directive in ``. 4. Restart Apache: `service apache2 restart` #### Installing Apache on CentOS [](#installing-apache-on-centos) 1. Install Apache: `yum -y install httpd` For additional information, see the [Apache site](http://httpd.apache.org/docs/2.4/platform/rpm.html). 2. Enable [server rewrites](http://unix.stackexchange.com/questions/57946/enable-apache-mod-rewrites-to-load-clean-urls). **Note**: You must change the value of `Allow Override` in the directive for the directory to which you expect to install the Magento software. For example, to install in the web server docroot, edit the directive in ``. 3. Set the type of directives that can be used in `.htaccess`. Magento uses `.htaccess` for redirects. [Apache documentation](http://httpd.apache.org/docs/2.2/mod/core.html#allowoverride). 4. Restart Apache: `service httpd restart` ### MySQL [](#mysql) #### Installing MySQL on Ubuntu [](#installing-mysql-on-ubuntu) 1. Install MySQL on [Ubuntu 12](https://rtcamp.com/tutorials/mysql/mysql-5-6-ubuntu-12-04/) or [Ubuntu 14](http://www.tocker.ca/2014/04/21/installing-mysql-5-6-on-ubuntu-14-04-trusty-tahr.html). 2. Configure the database instance. #### Installing and configuring MySQL on CentOS [](#installing-and-configuring-mysql-on-centos) The following procedure is based on [Install MySQL Server 5.6 in CentOS 6.x and Red Hat 6.x Linux](http://sharadchhetri.com/2013/12/26/install-mysql-server-5-6-in-centos-6-x-and-red-hat-6-x-linux/). 1. Install the MySQL database: ``` cd /tmp ``` wget rpm -ivh mysql-community-release-el6-5.noarch.rpm yum -y install mysql-server 2. Start MySQL. `service mysqld start` 3. Set a password for the root user and set other security-related options. Enter the following command and follow the prompts on your screen to complete the configuration. `mysql_secure_installation` #### Configuring the Magento database instance [](#configuring-the-magento-database-instance) This section discusses how to create a new database instance for Magento. Although a new database instance is recommended, you can optionally install Magento into an existing database instance. To configure a MySQL database instance: 1. Log in to your database server as any user. 2. Enter the following command to get to a MySQL command prompt: `mysql -u root -p` 3. Enter the MySQL `root` user's password when prompted. 4. Enter the following commands in the order shown to create a database instance named `magento` with user name `magento`: ``` create database magento; ``` GRANT ALL ON magento.\* TO magento@localhost IDENTIFIED BY 'magento'; 5. Enter `exit` to quit the command prompt. ### PHP [](#php) Magento 2 requires PHP 5.4.11 or later or PHP 5.5.x. **Note**: Magento 2 does *not* support PHP 5.6. ### PHP 5.5 or 5.4 on Ubuntu [](#php-55-or-54-on-ubuntu) ##### Install PHP 5.5 on Ubuntu 14 [](#install-php-55-on-ubuntu-14) To install PHP 5.5 on Ubuntu 14: 1. Enter the following command: `apt-get -y install php5` 2. Verify the PHP version by entering `php -v`. Messages similar to the following should display: ``` PHP 5.5.9-1ubuntu4.4 (cli) (built: Sep 4 2014 06:56:34) Copyright (c) 1997-2014 The PHP Group Zend Engine v2.5.0, Copyright (c) 1998-2014 Zend Technologies with Zend OPcache v7.0.3, Copyright (c) 1999-2014, by Zend Technologies ``` ##### Install PHP 5.5 on Ubuntu 12 [](#install-php-55-on-ubuntu-12) 1. Use the following commands from [dev-metal](http://www.dev-metal.com/how-to-setup-latest-version-of-php-5-5-on-ubuntu-12-04-lts/): ``` add-apt-repository ppa:ondrej/php5 apt-get update sudo apt-get install php5 ``` 2. Verify the PHP version by entering `php -v`. Messages similar to the following should display: ``` PHP 5.5.18-1+deb.sury.org~precise+1 (cli) (built: Oct 17 2014 15:11:34) Copyright (c) 1997-2014 The PHP Group Zend Engine v2.5.0, Copyright (c) 1998-2014 Zend Technologies with Zend OPcache v7.0.4-dev, Copyright (c) 1999-2014, by Zend Technologies ``` ##### Install PHP 5.4 on Ubuntu 12 [](#install-php-54-on-ubuntu-12) To install PHP 5.4 on Ubuntu 12: 1. Use the following instructions from [askubuntu](http://askubuntu.com/questions/109404/how-do-i-install-latest-php-in-supported-ubuntu-versions-like-5-4-x-in-ubuntu-1): ``` add-apt-repository ppa:ondrej/php5-oldstable apt-get update apt-get upgrade apt-get install php5 ``` 2. Verify the PHP version by entering `php -v`. Messages similar to the following should display: ``` PHP 5.4.33-2+deb.sury.org~precise+1 (cli) (built: Sep 25 2014 09:06:25) Copyright (c) 1997-2014 The PHP Group Zend Engine v2.4.0, Copyright (c) 1998-2014 Zend Technologies ``` 3. Restart Apache: `service apache2 restart` ##### Upgrade to PHP 5.4 on Ubuntu [](#upgrade-to-php-54-on-ubuntu) To upgrade to PHP 5.4 on Ubuntu: 1. Use the instructions on [phpave](http://phpave.com/upgrade-php-5-3-php-5-5-ubuntu-12-04-lts/). 2. After upgrading, verify the PHP version by entering `php -v`. Messages similar to the following should display: ``` PHP 5.4.33-2+deb.sury.org~precise+1 (cli) (built: Sep 25 2014 09:06:25) Copyright (c) 1997-2014 The PHP Group Zend Engine v2.4.0, Copyright (c) 1998-2014 Zend Technologies ``` 3. Restart Apache: `service apache2 restart` #### Install required PHP extensions on Ubuntu [](#install-required-php-extensions-on-ubuntu) Enter the following command to install required PHP extensions: ``` apt-get -y install php5 php5-mhash php5-mcrypt php5-curl php5-cli php5-mysql php5-gd ``` #### Ubuntu 14 only: workaround for mcrypt issue [](#ubuntu-14-only-workaround-for-mcrypt-issue) There is a [known issue](https://bugs.launchpad.net/ubuntu/+source/php-mcrypt/+bug/1240590) in Ubuntu 14 with the `mcrypt` PHP extension. To work around the issue, see [askubuntu](http://askubuntu.com/questions/450825/ubuntu-14-04-phpmyadmin-cant-find-mcrypt-extension). #### PHP 5.5 or 5.4 on CentOS [](#php-55-or-54-on-centos) PHP 5.3 is the default PHP version on CentOS distributions. Upgrade to PHP 5.4 using a repository like [remi](http://blog.famillecollet.com/pages/Config-en). The following resources are also available: - [kb.parallels](http://kb.parallels.com/en/115875) - [stackoverflow](http://stackoverflow.com/questions/21502656/upgrading-php-on-centos-6-5-final) - [remi repository](http://rpms.famillecollet.com/) To verify if PHP is installed already, enter `php -v`. If PHP is *not* installed, install it by entering the following command: ``` yum -y install php php-xml ``` ##### PHP 5.5 on CentOS [](#php-55-on-centos) To upgrade to PHP 5.5: There is more than one way to upgrade CentOS 6.5 to PHP 5.5; the following is a suggestion only. Consult a reference for additional options. Enter the following commands in the order shown. ``` cd /tmp rpm -Uvh https://mirror.webtatic.com/yum/el6/latest.rpm yum -y remove php-common-5.3.3-40.el6_6.x86_64 yum -y install php55w php55w-opcache ``` Restart Apache: `service httpd restart` ##### PHP 5.4 on CentOS [](#php-54-on-centos) To upgrade to PHP 5.4: 1. Enter the following commands: ``` cd /tmp rpm -Uvh http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm rpm -Uvh http://rpms.famillecollet.com/enterprise/remi-release-6.rpm yum -y --enablerepo=remi install httpd php php-common ``` 2. To verify PHP 5.4 is installed, enter `php -v`. The command displays results similar to the following: ``` PHP 5.4.33 (cli) (built: Sep 20 2014 16:20:03) Copyright (c) 1997-2014 The PHP Group Zend Engine v2.4.0, Copyright (c) 1998-2014 Zend Technologies ``` 3. Restart Apache: `service httpd restart` #### Install required PHP extensions on CentOS [](#install-required-php-extensions-on-centos) Enter the following command to install required PHP extensions: `yum -y --enablerepo=remi install php-xml php-mcrypt.x86_64 gd gd-devel php-gd php-mysql` #### Setting the PHP timezone (all operating systems) [](#setting-the-php-timezone-all-operating-systems) Before you install Magento, you might need to set the system time zone for PHP; otherwise, errors like the following display during the installation and time-related operations like cron might not work: `PHP Warning: date(): It is not safe to rely on the system's timezone settings.` \[more messages follow\] To set your time zone: 1. Locate your server's time zone in the available [time zone settings](http://php.net/manual/en/timezones.php). 2. Locate `php.ini` by entering the following command: `php -i | grep "Loaded Configuration File"` Typical locations follow: Ubuntu: `/etc/php5/cli/php.ini` CentOS: `/etc/php.ini` 3. Open `php.ini` in a text editor. 4. Locate the following setting and uncomment it if necessary: `date.timezone =` 5. Add the time zone setting you found in step 1. 6. Save your changes to `php.ini` and exit the text editor. #### Setting the PHP memory limit (all operating systems) [](#setting-the-php-memory-limit-all-operating-systems) Increase `memory_limit` in `php.ini` to at least 512MB for normal operation or 2GB for testing: 1. Open one of the following in a text editor: - Ubuntu: `/etc/php5/apache2/php.ini` - CentOS: `/etc/php.ini` 2. Change `memory_limit` to: `memory_limit = 512M` or more for normal operation `memory_limit = 2G` or more for testing 3. Save your changes and exit the text editor. 4. Restart Apache: Ubuntu: `service apache2 restart` CentOS: `service httpd restart` Installing Composer ------------------- [](#installing-composer) To install Composer: 1. Change to or create an empty directory on your Magento server. 2. Enter the following commands: ``` curl -sS https://getcomposer.org/installer | php mv composer.phar /usr/local/bin/composer ``` For additional installation options, see the [Composer installation documentation](https://getcomposer.org/download/). Cloning the Magento 2 GitHub repository --------------------------------------- [](#cloning-the-magento-2-github-repository) To clone the Magento 2 GitHub repository: 1. Change to your web server's docroot directory. Typically, for Ubuntu, it's `/var/www` and for CentOS it's `/var/www/html`. 2. Enter any of the following commands as a user with privileges to write to the web server docroot: To clone using HTTPS, use either of the following: `git clone https://github.com/magento/magento2.git` `git clone https://[your github.com user name]:[password]@github.com/magento/magento2.git` To clone using SSH: `git clone git@github.com:magento/magento2.git` 3. Wait for the repository to clone on your server. **Note**: If you get an error that includes `Permission denied (publickey)`, see [Troubleshooting](#troubleshooting). Installing or reinstalling the Magento 2 software ------------------------------------------------- [](#installing-or-reinstalling-the-magento-2-software) Before you begin, make sure that: 1. Your system meets the requirements discussed in [Magento 2 system requirements](#magento-2-system-requirements). 2. You completed all prerequisite tasks discussed in [Prerequisites.](#prerequisites) 3. You [installed Composer](#installing-composer). 4. You [cloned the Magento 2 GitHub repository](#cloning-the-magento-2-github-repository). ### Setting file system permissions and ownership before you install [](#setting-file-system-permissions-and-ownership-before-you-install) To make sure the installation completes successfully, we suggest the following file system permissions and ownership: - All files and directories owned by the web server user - Certain directories must be writable #### Finding the web server user [](#finding-the-web-server-user) To find the web server user, enter one of the following commands: - Ubuntu: `ps -ef | grep apache2` - CentOS: `grep User /etc/httpd/conf/httpd.conf` #### Pre-installation permissions and ownership [](#pre-installation-permissions-and-ownership) Before the installation, set the following permissions: - All directories have 700 permissions `(drwx------)`. 700 permissions give full control (that is, read/write/execute) to the owner and no permissions to anyone else. - All files have 600 permissions `(-rw-------)`. 600 permissions mean the owner can read and write but other users have no permissions. #### Setting permissions and ownership [](#setting-permissions-and-ownership) 1. To set ownership, enter the following commands as a user with `root` privileges: ``` cd [your Magento installation directory] chown -R [web server user name] . ``` CentOS example: ``` cd /var/www/html/magento2 chown -R apache . ``` Ubuntu example: ``` cd /var/www/magento2 chown -R www-data . ``` 2. Set file and directory permissions: ``` find . -type d -exec chmod 700 {} \; find . -type f -exec chmod 600 {} \; ``` ### Getting started with your installation [](#getting-started-with-your-installation) After you complete the tasks discussed in the preceding section, update Composer and run the installer: 1. Log in to your Magento server as a user with `root` privileges. 2. Change to the Magento 2 installation directory. For example, `cd /var/www/html/magento2` **Note**: On Ubuntu, you might have to use the `sudo -s` or equivalent command to access this directory. 3. As user with privileges to write to the web server docroot, enter `composer install` This command updates package dependencies and can take a few minutes to complete. 4. Change to the Magento 2 `setup` subdirectory and enter `composer install`. **Note**: You must run `composer install` from *both* directories. ### Running the Magento 2 installer [](#running-the-magento-2-installer) This section discusses how to run the command-line installer for Magento 2. **Note**: You must install Magento from its `setup` subdirectory. The installer is designed to be run multiple times if necessary so you can: - Provide different values For example, after you configure your web server for Secure Sockets Layer (SSL), you can run the installer to set SSL options. - Correct mistakes in previous installations - Install Magento in a different database instance **Note**: By default, the installer doesn't overwrite the Magento database if you install the Magento software in the same database instance. You can use the optional clean\_database parameter to change this behavior. **Note**: If you get errors during the installation, see [Troubleshooting](#troubleshooting). Before you begin, you can run the following commands to find values for some required options: Installer option Command Language `php -f index.php help languages` Time zone `php -f index.php help timezones` Currency `php -f index.php help currencies` ``` The format of the command follows: php -f index.php install [--[installation option name]=[installation option value] ... The following table discusses the meanings of installation option names and values. An example is provided in Sample localhost installation. ``` ``` admin_firstname Magento administrator user's first name. Yes admin_lastname Magento administrator user's last name. Yes admin_email Magento administrator user's e-mail address. Yes admin_username Magento administrator user name. Yes admin_password Magento administrator user password. Yes language Language code to use in the Admin and storefront. (If you have not done so already, you can view the list of language codes by entering php -f index.php help languages from the setup directory.) Yes currency Default currency to use in the storefront. (If you have not done so already, you can view the list of currencies by entering php -f index.php help currencies from the setup directory.) Yes timezone Default time zone to use in the Admin and storefront. (If you have not done so already, you can view the list of time zones by entering php -f index.php help timezones from the setup directory.) Yes use_secure 1 enables the use of Secure Sockets Layer (SSL) in all URLs (both Admin and storefront). Make sure your web server supports SSL before you select this option. 0 disables the use of SSL with Magento. In this case, all other secure URL options are assumed to also be 0. No base_secure_url 1 means SSL is preferred in Magento URLs designed to use it (for example, the checkout page). Make sure your web server supports SSL before you select this option. 0 means SSL is not used. No use_secure_admin 1 means you use SSL to access the Magento Admin. Make sure your web server supports SSL before you select this option. 0 means you do not use SSL with the Admin. No admin_use_security_key 1 causes the Magento software to use a randomly generated key value to access pages in the Magento Admin and in forms. These key values help prevent cross-site script forgery attacks. 0 disables the use of the key. No session_save Use any of the following: files to store session data in the file system. File-based session storage is appropriate unless the Magento file system access is slow or you have a clustered database. db.files to store session data in the database. Choose database storage if you have a clustered database; otherwise, there might not be much benefit over file-based storage. No key If you have one, specify a key to encrypt sensitive data in the Magento database. (This includes passwords and personally identifiable customer information.) If you don't have one, Magento generates one for you. No cleanup_database To drop database tables before installing the Magento 2 software, specify this parameter without a value. Otherwise, the Magento database is left intact. No db_init_statements Advanced MySQL configuration parameter. Uses database initialization statements to run when connecting to the MySQL database. Consult a reference similar to this one before you set any values. No sales_order_increment_prefix Specify a string value to use as a prefix for sales orders. Typically, this is used to guarantee unique order numbers for payment processors. No ``` Name Value Required? base\_url Base URL to use to access your Magento Admin and storefront in the format http\[s\]://\[host or ip\]/\[your Magento base dir\]/. **Note**: The scheme (`http://` or `https://`) and a trailing slash are *both* required. \[your Magento base dir\] is the docroot-relative path in which to install the Magento 2 software. Depending on how you set up your web server and virtual hosts, the path might be magento2 or it might be blank. To access Magento on localhost, you can use either `http://localhost/[your Magento base dir]/` or `http://127.0.0.1/[your Magento base dir]/`. Yes backend\_frontname Path to access the Magento Admin. This path is appended to Base URL. For example, if Base URL is and Admin Path is `admin`, the Admin Panel's URL is `http://www.example.com/admin`—provided you configured your web server for server rewrites. Yes db\_host Use any of the following: - The database server's fully qualified host name or IP address. - `localhost` if your database serve is on the same host as your web server. - UNIX socket; for example, `/var/run/mysqld/mysqld.sock` **Note**: You can optionally specify the database server port in its host name like `www.example.com:9000` Yes db\_name Name of the Magento database instance in which you want to install the Magento database tables. Yes db\_user User name of the Magento database instance owner. Yes db\_pass Magento database instance owner's password. No db\_prefix Use only if you're installing the Magento database tables in a database instance that has Magento tables in it already. In that case, use a prefix to identify the Magento tables for this installation. Some customers have more than one Magento instance running on a server with all tables in the same database. This option enables those customers to share the database server with more than one Magento installation. No #### Sample localhost installation [](#sample-localhost-installation) The following example installs Magento with the following options: - The Magento software is installed in the `magento2` directory relative to the web server docroot on `localhost` and the path to the Magento Admin is `admin`; therefore: Your storefront URL is `http://localhost` and you can access the Magento Admin at `http://localhost/admin` - The database server is on the same host as the web server. The database name is `magento`, and the user name and password are both `magento` - The Magento administrator has the following properties: - First and last name are is `Magento User` - User name is `admin` and the password is `iamtheadmin` - E-mail address is `user@example.com` - Default language is `en_US` (U.S. English) - Default currency is U.S. dollars - Default time zone is U.S. Central (America/Chicago) ``` php -f index.php install --base_url=http://localhost/magento2/ --backend_frontname=admin --db_host=localhost --db_name=magento --db_user=magento --db_pass=magento --admin_firstname=Magento --admin_lastname=User --admin_email=user@example.com --admin_username=admin --admin_password=iamtheadmin --language=en_US --currency=USD --timezone=America/Chicago ``` ### Reinstalling the Magento 2 software [](#reinstalling-the-magento-2-software) This section discusses how to install the Magento 2 software after you installed it previously. You might do this in an development environment especially to get all the latest code changes. To reinstall the Magento 2 software: 1. Optionally delete and re-create the database instance. 2. Log in to your Magento server as a user with permissions to modify files in the Magento file system. 3. Enter the following commands in the order shown: ``` cd [your Magento install dir] ``` git pull composer install cd setup composer install 4. Repeat the tasks discussed in [Installing or reinstalling the Magento 2 software](#installing-or-reinstalling-the-magento-2-software). Verifying the installation -------------------------- [](#verifying-the-installation) ### Verifying the storefront [](#verifying-the-storefront) Go to the storefront in a web browser. For example, if your Magento 2 installation base URL is `http://www.example.com`, enter it in your browser's address or location bar. The following figure shows a sample storefront page. If it displays as follows, your installation was a success! [![Magento storefront which verifies a successful installation](success.png)](success.png) If the page appears unconfigured (no styles, only text), see [Troubleshooting](troubleshooting). ### Verifying the Magento Admin [](#verifying-the-magento-admin) Go to the Magento Admin in a web browser. For example, if your Magento 2 installation base URL is `http://www.example.com`, and the Admin URL is `admin`, enter `http://www.example.com/admin` in your browser's address or location bar. (The Admin URL is specified by the value of the `backend_frontname` installation parameter.) When prompted, log in as a Magento Administrator. The following figure shows a sample Magento Admin page. If it displays as follows, your installation was a success! [![Magento Admin which verifies a successful installation](success_admin.png)](success_admin.png) If the page appears unconfigured (no styles, only text), see [Troubleshooting](troubleshooting). If you get a 404 (Not Found) error similar to the following, see [Troubleshooting](troubleshooting): `The requested URL /magento2index.php/admin/admin/dashboard/index/key/0c81957145a968b697c32a846598dc2e/ was not found on this server.` Troubleshooting --------------- [](#troubleshooting) ### Problem: Cannot clone the Magento 2 GitHub repository [](#problem-cannot-clone-the-magento-2-github-repository) **Detail**: Error is similar to the following: ``` Cloning into 'magento2'... Permission denied (publickey). fatal: The remote end hung up unexpectedly ``` **Solution**: Upload your SSH key to GitHub as discussed in [the GitHub help page](https://help.github.com/articles/generating-ssh-keys). ### Problem: Cannot run 'composer install' [](#problem-cannot-run-composer-install) **Suggestion**: Change to the directory in which you installed Composer and enter the following command: `mv composer.phar /usr/local/bin/composer` ### Problem: During installation, PHP date warning [](#problem-during-installation-php-date-warning) **Details**: During the installation, the following message displays: `PHP Warning: date(): It is not safe to rely on the system's timezone settings. [more]` **Solution**: [Set the PHP timezone properly](#php). ### Problem: During installation, the following fatal error displays: [](#problem-during-installation-the-following-fatal-error-displays) `PHP Fatal error: Class 'PDO' not found in /var/www/html/magento2/setup/module/Magento/Setup/src/Module/Setup/ConnectionFactory.php on line 44` **Solution**: Make sure you installed all required [PHP extensions](#php). ### Problem: You cannot access Magento in a web browser [](#problem-you-cannot-access-magento-in-a-web-browser) **Details**: The following message displays when you try to access the Magento storefront or Admin: ``` Whoops, it looks like you have an invalid PHP version. Magento supports PHP 5.4.11 or newer. ``` **Solution**: Either [upgrade PHP](#php) or restart Apache (Apache might not be using the same PHP version as is on the file system). To restart Apache: - Ubuntu: `service apache2 restart` - CentOS: `service httpd restart` ### Problem: Error after logging in to the Magento Admin: [](#problem-error-after-logging-in-to-the-magento-admin) `The requested URL /magento2index.php/admin/admin/dashboard/index/key/0c81957145a968b697c32a846598dc2e/ was not found on this server.` Note the lack of a slash character between magento2 and index.php in the URL. **Solution**: The base URL is not correct. The base URL must start with http:// or https:// *and* it must end with a slash (/). Run the installation again with a valid value. ### Problem: After installing, images and stylesheets do not load; only text displays, no graphics. [](#problem-after-installing-images-and-stylesheets-do-not-load-only-text-displays-no-graphics) **Details**: The path to images and stylesheets is not correct, either because of an incorrect base URL or because [server rewrites](#apache) are not set up properly. To confirm this is the case, use a web browser inspector to check the paths to static assets and verify those assets are located on the Magento file system. Magento 2 static assets should be located under `[your Magento install dir]/pub/static/` (there should be `frontend` and `adminhtml` directories). Verify your server rewrites setting and your base URL and try again. ### Health Score 21 — LowBetter than 19% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community9 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor1 Top contributor holds 95% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/63fe7f0028b5ee799c98a845601b03a641a077f70865db4e25b97001b4eae215?d=identicon)[joanhe](/maintainers/joanhe) --- Top Contributors [![magento-team](https://avatars.githubusercontent.com/u/1229310?v=4)](https://github.com/magento-team "magento-team (19 commits)")[![joanhe](https://avatars.githubusercontent.com/u/9272701?v=4)](https://github.com/joanhe "joanhe (1 commits)") ### Embed Badge ![Health badge](/badges/joanhe-poc-m2-ce-project/health.svg) ``` [![Health](https://phpackages.com/badges/joanhe-poc-m2-ce-project/health.svg)](https://phpackages.com/packages/joanhe-poc-m2-ce-project) ``` ### Alternatives [laravel/telescope An elegant debug assistant for the Laravel framework. 5.2k67.8M192](/packages/laravel-telescope)[spiral/roadrunner RoadRunner: High-performance PHP application server and process manager written in Go and powered with plugins 8.4k12.2M84](/packages/spiral-roadrunner)[nolimits4web/swiper Most modern mobile touch slider and framework with hardware accelerated transitions 41.8k177.2k1](/packages/nolimits4web-swiper)[laravel/dusk Laravel Dusk provides simple end-to-end testing and browser automation. 1.9k36.7M259](/packages/laravel-dusk)[laravel/prompts Add beautiful and user-friendly forms to your command-line applications. 708181.8M596](/packages/laravel-prompts)[cakephp/chronos A simple API extension for DateTime. 1.4k47.7M121](/packages/cakephp-chronos) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)