Told you they'd come back.

doc/guides/7 - Hosting/1 - How to Install Refinery on Heroku.textile

@@ -0,0 +1,87 @@
+h2. How to Install Refinery on Heroku
+
+"Heroku":http://heroku.com is a popular hosting choice for many developers. This guide will show you how to:
+
+* Install and deploy Refinery on the Heroku hosting platform
+
+endprologue.
+
+h3. Starting Out
+
+First you need to install Refinery. To do that you need the refinerycms gem.
+
+<shell>
+gem install refinerycms
+</shell>
+
+Next go to "Heroku.com":Heroku.com and click "sign up" for a free account.
+
+Now you've got a Heroku account, install the Heroku gem and provide your account credentials:
+
+<shell>
+gem install heroku
+heroku list
+</shell>
+
+Now it's time to create your Refinery application using the built in +--heroku+ option
+
+<shell>
+refinerycms myapp --heroku
+</shell>
+
+Watch the output for these lines
+
+<shell>
+Creating Heroku app..
+Running: cd /path/to/app/myapp && heroku create
+Creating random-site-name..... done
+Created http://random-site-name.heroku.com/
+</shell>
+
+This will output the URL for your Heroku hosted Refinery application. Your application should now be live at http://random-site-name.heroku.com
+
+NOTE: if you already have a refinery app you would like to deploy then just deploy as normal according to Heroku's instructions. You do not need to run the +--heroku+ flag, as all it does is automate some things.
+
+h3. Adding Amazon S3 Support
+
+If you want to use Refinery's image and resource support you'll need to setup storage too. Create a bucket called "my_app_production" and uncomment this line in your Gemfile (this might already be done for you):
+
+<ruby>
+gem 'aws-s3'
+</ruby>
+
+Next tell Heroku about your new S3 bucket.
+
+<shell>
+heroku config:add S3_KEY=123key S3_SECRET=456secret S3_BUCKET=my_app_production
+</shell>
+
+That's it! Heroku will restart your site and it should be live with S3 support.
+
+h3. Troubleshooting
+
+h4. Missing a required gem
+
+Simply add that gem to the Gemfile.
+
+h4. Acts As Indexed giving you problems (RefineryCMS version 0.9.7.13 and below)
+
+Make sure that you are using at least version 0.6.6 (latest at time of writing) by putting this in your Gemfile (instead of the current entry):
+
+<ruby>
+gem 'acts_as_indexed', '= 0.6.6'
+</ruby>
+
+h4. Images or Resources don’t work
+
+Double check your S3_ information and make sure that the right buckets actually exist.
+
+h4. Other problems?
+
+Try forcing +s3_backend+ to be true by adding the following line to the _end_ of +config/environments/production.rb+:
+
+<ruby>
+Refinery.s3_backend = true
+</ruby>
+
+Otherwise, hop on to the IRC Channel and ask either stevenheidel or parndt for help. Or, run heroku logs and see if you can spot the error yourself.

doc/guides/7 - Hosting/3 - How to Install Refinery on Duostack.textile

@@ -0,0 +1,72 @@
+h2. How to Install Refinery on Duostack
+
+"Duostack":http://duostack.com is a new hosting choice for Ruby/Rails or Node.js developers. This guide will show you how to:
+
+* Install and deploy Refinery on the Duostack Rails hosting platform
+
+endprologue.
+
+WARNING. This guide is based on Refinery 0.9.9. The automated Duostack installation shown here will not work in earlier versions of Refinery.
+
+h3. Starting Out
+
+First you need to install Refinery. To do that you need the refinerycms gem.
+
+<shell>
+gem install refinerycms
+</shell>
+
+Next go to "Duostack.com":http://duostack.com and click "Request Beta Access" for a free beta account (you will have to fill out a form and wait for their response to your request - make sure you mention Refinery CMS "for priority":http://twitter.com/duostack/status/26856205687201793).
+
+Now you've got a Duostack account, install the Duostack gem by following their instructions under "Ruby Gem":
+
+"Command Line Client (external link, docs.duostack.com)":http://docs.duostack.com/command-line-client#setup
+
+Now it's time to create your Refinery application using the built in +--duostack+ option
+
+WARNING: Make sure you specify an application name (+my_app_name+ below) as this is required by Duostack.
+
+<shell>
+refinerycms myapp --duostack my_app_name
+</shell>
+
+Watch the output for these lines
+
+<shell>
+Creating Duostack app..
+Running: cd /path/to/app/myapp && duostack create
+...
+====  Launching first instances.......... done
+
+====  App successfully deployed to http://site-name.duostack.net
+</shell>
+
+This will output the URL for your Duostack hosted Refinery application. Your application should now be live at http://site-name.duostack.net
+
+NOTE: if you already have a Refinery application that you would like to deploy then just deploy as normal according to Duostack's instructions. You do not need to run the +--duostack+ flag, as all it does is automate some things.
+
+h3. Adding Amazon S3 Support
+
+If you want to use Refinery's image and resource support you'll need to setup storage too. Create a bucket called "my_app_production" and uncomment this line in your Gemfile (this might already be done for you):
+
+<ruby>
+gem 'aws-s3'
+</ruby>
+
+Next tell Duostack about your new S3 bucket.
+
+<shell>
+duostack env add S3_KEY=123key S3_SECRET=456secret S3_BUCKET=my_app_production
+duostack restart
+</shell>
+
+That's it! Duostack will restart your site and it should be live with S3 support.
+
+h3. Troubleshooting
+
+h4. Missing a required gem
+
+Simply add that gem to the Gemfile.
+
+Otherwise, hop on to the IRC Channel and ask someone for help. Or, see if you can open the duostack logs to spot the error yourself.
+Being that this is a new service it may be best to ask Duostack for assistance.