Getting Magento up and running is pretty simple. There are a few things to be aware of when launching Magento on Pagoda Box. After reading this, you should be able to:
- Create a local instance of Magento
- Take your local instance of Magento and deploy it to Pagoda Box
- Create a Pagoda database and access it from your Magento app
- Bask in the combined awesomeness of Magento and Pagoda Box
Magento Core Patches
Duplicate Headers Fix (All Versions)
In Magento Community & Enterprise editions, there is a bug with running PHP as a (fast) CGI with FPM. Because FPM does not accept dual status or Content-Type header, the server returns a duplicate header error.
In Community Edition this can cause problems with using the SOAP API, which will also result in broken dashboard graphs. In Enterprise Edition it results in 500 errors when Full Page Caching is enabled.
The problem lies in the file:
This can be patched by downloading this file and using it to override the core file.
See this Magento Forum Post for more details.
Change Location of Cache File (Versions 188.8.131.52 and Earlier)
Magento versions 184.108.40.206 and earlier store information related to your cache in the
directory. In order to write files to the
directory, it would need to be made writable which would mean that it would no longer be tracked in your git repo. Any changes made to
would then not be committed or deployed. A simple fix for this is to change where the cache file is written. Make the following change to line 1102 of
Patch for Magento Versions 220.127.116.11 and Earlier PHP
For a basic Magento install on Pagoda Box, the
is pretty simple, but there are some things you should note. The following Boxfile includes a
that overwrites your local
that is used on Pagoda Box. This technique is covered in more detail
The Boxfile also contains a web service with necessary PHP extensions and network directories, a network storage service to house network directories, and a MySQL database.
Magento Boxfile Example YAML
Identifying media as a network directory will allow you to upload images, video, and other media to your live Magento app. The PHP extensions are those required by the Magento System Requirements. The "database1" service will automatically create an empty database for your application.
Also, refer to our Magento Optimization doc for optional Boxfile settings your app may benefit from.
If you want to know more about writing or customizing your own Boxfile, check out Boxfile doc. Any settings you define in your own Boxfile will override settings defined in the default Boxfile.
Create a Local Instance of Magento
Get your Magento app up and running locally. We’re assuming that you’ve already done this. If you haven’t and don’t know how, here’s a link for you: Create a local Magento instance
No Auto-Installers on Pagoda Box
You are not able to run auto-installers on Pagoda Box. If you use Magento's auto-installer, run it locally to generate all the necessary configuration files, then deploy your app to Pagoda Box.
Create a 2nd local.xml
Magento houses it's database connection details in the
file. Typically, you could just include the
auto-generated environment variables
created when your database is deployed, but xml doesn't support server variables. The deploy hook included in the example Boxfile above replaces the
that connects your local instance of Magento to your local database with the
that will connect your live Magento site to your Pagoda Box database. This technique will allow you to work seamlessly between your local and live environments without having to modify your
directory in the root of your Magento app and copy the
directory. Once your app is deployed on Pagoda Box and your database is created, you'll be able to input the correct database connection details in your
This can only be done
after your app has been deployed for the first time.
During development, we recommend configuring Magento to display errors by making the following change in your index.php file.
Display Errors PHP
Create a Git Repo for Your Magento App
If you haven’t used Git before, the Basics of Using Git with Pagoda Box is a great place to start. If you're looking for a deeper dive into Git, Getting Started with Git is a great free online resource.
Launch Your Magento App on Pagoda Box
Just go through the normal process of launching an app. If you aren’t sure what the process is, the Launching an App doc covers the different options.
Once your app has been successfully created, if you view it live, you'll see an error page that looks something like the following:
This is because the database connection details in your
are still configured your app to connect the new Pagoda database instead of your local database.
No Error, Just a Number?
If you get just screen with an error number, it’s probably because errors haven't been configured to display.
Put the Correct Connection Details in pagoda/local.xml
Once your app has been launched and you database has been created, you can get the correct database connection credentials to put in your
In your App Dashboard, click on your database service to expands its details. Then click on the "Credentials" tab.
Replace the database connection details in
with the credentials found in your App Dashboard.
Database Credentials in pagoda/local.xml XML
// NOTE : These are not your credentials. // Use your database's credentials found in your dashboard
<![CDATA[192.168.0.2]]> <![CDATA[jasmine]]> <![CDATA[RvebdoLF]]> <![CDATA[gopagoda]]>
Save your changes and push them to Pagoda Box. Once deployed, both your local and live apps will be able to connect to the correct databases without any further changes.
Migrate Your Data
Chances are you have an existing product database that needs to be migrated to your new app. The Migrating Existing Data doc walks through the different options.
Your App is Up & Running on Pagoda Box
Once your data is migrated, your Magento app should be up and running and ready to rock on Pagoda Box. There are still a few things you may need to do to get your app fully functional. They are covered in these docs:
Disable Display Errors
If you set errors to display, now would be a good time to turn it off. Unless of course you're still debugging your Magento app.
This doc has only covered the minimum requirements for getting Magento up and running. Check out our Magento Optimizations doc for additional suggestions and configuration options.
Post Launch Workflow
Pagoda Box makes managing and updating your Magento app really easy, but there’s some things you should know.
Any updates, plugins, themes, or any other code changes need to be done on your local instance first, then pushed to your repo and deployed through your app dashboard.
Remember that your local database and your live database are two completely separate databases. Anytime you want to publish a new post or add media to your Magento app, it needs to be done through your live admin, not your local admin. Your Magento content is not stored in your repo so any content you add locally will not be pushed live with your repo.
Table of Contents
- Duplicate Headers Fix (All Versions)
- Change Location of Cache File (Versions 18.104.22.168 and Earlier)
- HPatch for Magento Versions 22.214.171.124 and Earlier
- HNo Auto-Installers on Pagoda Box
- Create a 2nd local.xml
- Display Errors
- HDisplay Errors
- Create a Git Repo for Your Magento App
- HNo Error, Just a Number?
- Put the Correct Connection Details in pagoda/local.xml
- HDatabase Credentials in pagoda/local.xml
If you have any questions, suggestions, or corrections, let us know.