Move docs from gh-pages branch.

1 files changed, 78 insertions, 0 deletions

diff --git a/docs/install/ami.md b/docs/install/ami.md
new file mode 100644
index 000000000..783c23727
--- /dev/null
+++ b/docs/install/ami.md
@@ -0,0 +1,78 @@
+---
+layout: page
+title: AMI for EC2
+---
+
+# FixMyStreet AMI for EC2
+
+<p class="lead">
+  To help people to get started with the FixMyStreet platform, we have
+  created an AMI (Amazon Machine Image) with a basic installation of
+  FixMyStreet, which you can use to create a running server on an Amazon
+  EC2 instance.
+</p>
+
+Note that this is just one of [four ways to install FixMyStreet]({{ "/install/" | relative_url }}).
+
+## Installing on Amazon's Web Services
+
+If you don't have your own server, or simply prefer to use an external one, you
+can use Amazon Web Services (AWS) instead. They provide difference scale
+servers, called instances. The smallest instance, the Micro, will be [free
+for a year](http://aws.amazon.com/free/).
+
+The AMI we've prepared for you can be found in the **EU West (Ireland)**
+region, with the ID `ami-0a9b70ca6708395b5` and name "FixMyStreet installation
+2018-09-06". You can launch an instance based on that AMI with
+[this link](https://console.aws.amazon.com/ec2/home?region=eu-west-1#launchAmi=ami-0a9b70ca6708395b5).
+
+When you create an EC2 instance based on that AMI, make sure that you
+choose Security Groups that allow at least inbound HTTP, HTTPS and
+SSH, and perhaps SMTP as well for email.
+
+When your EC2 instance is launched, you will be able to log in as the
+`ubuntu` user.  This user can `sudo` freely to run commands as root.
+However, the code is actually owned by (and runs as) the `fms` user.
+After creating the instance, you may want to edit a configuration
+file to set a couple of parameters.  That configuration file is
+`/home/fms/fixmystreet/conf/general.yml`, which can be edited with:
+
+    ubuntu@ip-10-58-191-98:~$ sudo su - fms
+    fms@ip-10-58-191-98:~$ cd fixmystreet
+    fms@ip-10-58-191-98:~/fixmystreet$ nano conf/general.yml
+
+You should set 
+<code><a href="{{ "/customising/config/#contact_email" | relative_url }}">CONTACT_EMAIL</a></code>
+and
+<code><a href="{{ "/customising/config/#do_not_reply_email" | relative_url }}">DO_NOT_REPLY_EMAIL</a></code>
+or whatever you wish to use. postfix is installed so that outgoing email will
+work, but this may need further configuration.
+
+Then you should restart the Catalyst FastCGI server with:
+
+    fms@ip-10-58-191-98:~/fixmystreet$ logout
+    ubuntu@ip-10-58-191-98:~$ sudo /etc/init.d/fixmystreet restart
+
+If you find the hostname of your EC2 instance from the AWS console,
+you should then be able to see the site at http://your-ec2-hostname.eu-west-1.compute.amazonaws.com
+
+By default, the admin part of the website (`/admin`) requires a user with
+superuser permission to log in. In order to use this
+interface, you will need to create a username and password for one or
+more superusers.  To add such a user, you can use the `createsuperuser`
+command, as follows:
+
+    ubuntu@ip-10-58-66-208:~$ sudo su - fms
+    fms@ip-10-58-191-98:~$ cd fixmystreet
+    fms@ip-10-58-191-98:~/fixmystreet$ bin/createsuperuser fmsadmin@example.org password
+    fmsadmin@example.org is now a superuser.
+
+This basic installation uses the default cobrand, with a
+(deliberately) rather garish colour scheme.  
+
+## Installation complete... now customise
+
+You should then proceed
+to [customise your installation](/customising/).
+
+Please also see the instructions for [updating your installation](/updating/ami/).