Installation Instructions
I had a lot of problems installing Magento 2. It took me many days and some assistance to get it working. Below is the set of instructions that I followed to a working installation.
Special thanks to @maddyC, as well as countless contributors on other forums whose content made it possible for me to piece this together.
--------------------------------------------------------------------------------
Requirements
- Server with PHP 5.6 and MySQL 5.6 (I used Ubuntu 15.10)
- SSH access (ability to execute commands via the command line)
I'm sorry if this is no help to those of you on shared servers with no SSH access. The installation should not be this complex.
--------------------------------------------------------------------------------
Preparation
1. Edit etc/php5/apache2/php.ini
Set max_execution_time = 18000
--------------------------------------------------------------------------------
Installation
1. Download Magento Community Edition
In my installation, I'm using the download that includes sample data. You can use whatever you like, but for the purposes of this example, my filename is:
Magento-CE-2.0.0_Samples.tar.bz2
2. Upload .tar.bz2 to your desired installation folder. I'm installing to my web root on Ubuntu 15.10, so the location is:
/var/www/html/Magento-CE-2.0.0_Samples.tar.bz2
3. Using the command line, navigate to the installation folder.
cd /var/www/html
We will execute all commands from this location. Very important.
3. Extract the contents of the compressed file.
tar jxf Magento-CE-2.0.0_Samples.tar.bz2
4. Move the compressed file out of the installation directory (or delete it, your choice).
mv Magento-CE-2.0.0_Samples.tar.bz2 /var/www/Magento-CE-2.0.0_Samples.tar.bz2
5. While still in the magento installation directory, set ownership to apache, which in Ubuntu 15.10 is:
chown -R :www-data .
^ Don't forget the space and dot (.) at the end. Very important.
6. Set permissions
sudo find . -type d -exec chmod 770 {} \; && sudo find . -type f -exec chmod 660 {} \; && sudo chmod u+x bin/magento
7. Make the required directories writable
chmod 755 -R app/etc
chmod 755 -R var
chmod 755 -R pub
8. Enable debug mode by editing the magento root .htaccess file. Remove the comment on the following line:
SetEnv MAGE_MODE developer
9. Execute the setup:install command, the general format of which is:
bin/magento setup:install --backend-frontname="[folder name you want for the admin directory]" --key="[your encryption key]" --db-host="localhost" --db-name="[your database name]" --db-user="[database user with permissions on the specified database]" --db-password="[db user password]" --base-url="[the URL to the current location, followed by a slash]" --admin-user="[the username you would like for the admin user]" --admin-password="[the password you would like for the admin user]" --admin-email="[your email address]" --admin-firstname="[your first name]" --admin-lastname="[your last name]" --use-sample-data
--key is optional. Magento uses an encryption key to keep data safe and if you don't specify one it will generate one.
--use-sample-data is only required if you want to load your store with sample data (which I do)
So the actual command I execute is:
bin/magento setup:install --backend-frontname="admin" --key="XXXX" --db-host="localhost" --db-name="mage" --db-user="mageuser" --db-password="XXXX" --base-url="http://23.253.57.183/" --admin-user="admin" --admin-password="XXXX" --admin-email="XXXX@gmail.com" --admin-firstname="Admin" --admin-lastname="Test" --use-sample-data
The process takes a moment to complete, then a success message is displayed:
[Progress: 362 / 362]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Magento Admin URI: /admin
But we're not done yet. At this point, visiting the store URL will display a blank page or an error. So we continue.
10. Disable maintenance mode.
bin/magento maintenance:disable
11. Edit app/etc/di.xml.
Locate the element named "developerMaterialization" and, within it, the element named "view_preprocessed".
Change the contents from
Magento\Framework\App\View\Asset\MaterializationStrategy\Symlink
to
Magento\Framework\App\View\Asset\MaterializationStrategy\Copy
12. Execute the static content deploy command.
php bin/magento setup:static-content:deploy
13. Set permissions on all content in pub/static
chmod 755 -R pub/static
You should now be able to view your magento website and sign in to the back end.
--------------------------------------------------------------------------------
I really hope Magento cleans this up so installation can complete in a simpler and more sane manner.
Hopefully this helps a few people.
