diff --git a/AMAZONAWS.md b/AMAZONAWS.md new file mode 100644 index 0000000..4238a86 --- /dev/null +++ b/AMAZONAWS.md @@ -0,0 +1,35 @@ +# OpenFuego in a(n Amazon) Box + +There is an AMI on Amazon Web Services that allows you to quickly deploy a cloud server to run OpenFuego. Search for 'OpenFuego' in the [AWS Marketplace](https://aws.amazon.com/marketplace/). You can use [EC2 for Poets](http://ec2.forpoets.org/) as a guide for launching and running your own AWS instance. A full guide for OpenFuego is forthcoming. Below I've documented what that box includes: + +## Software installed: + +* ubuntu 12.04 LTS +* apache2 +* php5 (with php5-curl) +* sendmail +* mysql-server (root password: 0p3n-fu3g0 - __change this immediately__) +* phpmyadmin (admin user password: 0p3n-fu3g0 - __change this immediately__) +* git + +## Commands run: + +Followed Phelps' instructions [here](https://github.com/niemanlab/openfuego/issues/4#issuecomment-21755406) + +Symlinked phpmyadmin (cmd: `ln -s /usr/share/phpmyadmin /var/www/phpmyadmin`) + +Created folder /var/www/openfuego - fetched OpenFuego from Nieman (run `git pull origin master` in that folder to update to latest version) + +Created index.php in /var/www that will quickly return some links as soon as they're pulled to test your implementation + +Removed rootlogin with password (keypair required) + +## What you need to do: + +Log in to phpmyadmin and change the [mysql](http://www.cyberciti.biz/faq/mysql-change-root-password/) and [phpmyadmin](http://stackoverflow.com/questions/14703223/mysql-phpmyadmin-reset-root-password) passwords + +Create database in phpmyadmin + +Copy and edit config.php with info + +Run fetch.php `php fetch.php` (I typically run w `-v` to see if there are any problems) diff --git a/README.md b/README.md index 56cb2fa..957618a 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,8 @@ OpenFuego is a backend application that runs at the command line. There is nothi Follow the instructions in config.php. Create a MySQL database and enter the credentials in that file, along with Twitter credentials and optional (but recommended) API keys for Bitly, Goo.gl, and Embed.ly. +You can also check out AMAZONAWS for instructions on running OpenFuego on Amazon Web Services' free tier. + ### Usage Once config.php is edited, run `fetch.php` at the command line. You may or not get further instructions, depending on whether your version of PHP is compiled with process control.