Hosting Facebook Apps on Pagoda Box

Last Updated December 2014

Many Facebook apps and promotions are designed to pull in traffic quickly, service users for a relatively short amount of time, then either ramp down or completely go away. Pagoda Box is perfect for these types of apps, providing functionality necessary to quickly ramp up to handle traffic, then scale back down when demand goes away. This doc walks through what you need to know to get started hosting Facebook apps on Pagoda Box. After reading it, you should be familiar with:

  • How Facebook Canvas Apps work
  • Requirements for hosting Facebook Apps on Pagoda
  • Rocking the social media world with scalable apps

Facebook Canvas Pages

“Apps on Facebook are web apps that are loaded in the context of Facebook in what [Facebook] refers to as a Canvas Page.

“A Canvas Page is quite literally a blank canvas within Facebook on which to run your app. You populate the Canvas Page by providing a Canvas URL that contains the HTML, JavaScript and CSS that make up your app. When a user requests the Canvas Page, [Facebook] loads the Canvas URL within an iframe on that page. This results in your app being displayed within the standard Facebook chrome.” 1

Facebook provides detailed documentation on how to setup a Canvas Page. It’s a simple process requiring a verified Facebook account. You can also run apps within a tab of a Facebook page. Facebook’s Page Tabs documentation covers how to set tabs up.

You Must Use Your Own Custom Domain

To host a Facebook app on Pagoda Box, you’ll need to use your own domain. Facebook does not allow apps using the “gopagoda.io” domain because the *.gopagoda.com SSL certificate is self-signed (more information below). Using custom domains on Pagoda Box is incredibly simple and only takes a few minutes to setup. Our Using Custom Domains doc walks through the process.

Facebook Requires Certified SSL

Facebook requires that all Canvas URLs use https and the SSL certificate is certified by an authorized certificate authority. It cannot be a self-signed certificate. This means you will need to install a SSL certificate for you own custom domain on your app. The Adding SSL doc outlines the process. You will need to successfully install an SSL certificate on your app before you begin the process of creating your Canvas Page.

Article References

1 developers.facebook.com/docs/games/canvas/

If you have any questions, suggestions, or corrections, let us know.