diff --git a/docsite/rst/gettingstarted.rst b/docsite/rst/gettingstarted.rst
index da72d1958b9..2f02b3348a7 100644
--- a/docsite/rst/gettingstarted.rst
+++ b/docsite/rst/gettingstarted.rst
@@ -125,6 +125,28 @@ Make sure you have ``rpm-build``, ``make``, and ``python2-devel`` installed.
     $ make rpm
     $ sudo rpm -Uvh ~/rpmbuild/ansible-*.noarch.rpm
 
+Via MacPorts
+++++++++++++
+
+An OSX port is available via MacPorts, to install the stable version of
+Ansible from MacPorts (this is the recommended way), run:
+
+.. code-block:: bash
+
+    $ sudo port install ansible
+
+If you wish to install the latest build via the MacPorts system from a
+git checkout, run:
+
+.. code-block:: bash
+
+    $ git clone git://github.com/ansible/ansible.git
+    $ cd ./ansible/packaging/macports
+    $ sudo port install
+
+Please refer to the documentation at <http://www.macports.org> for
+further information on using Portfiles with MacPorts.
+
 Debian, Gentoo, Arch, Others
 ++++++++++++++++++++++++++++
 
diff --git a/packaging/macports/README.md b/packaging/macports/README.md
new file mode 100644
index 00000000000..118e4148815
--- /dev/null
+++ b/packaging/macports/README.md
@@ -0,0 +1,13 @@
+This portfile installs ansible from the git repository, it will install the
+latest and greatest version of ansible. This portfile does not install the
+required dependancies to run in fireball mode.
+
+If you wish to run a stable version of ansible please do the following
+
+First update your macports repo to the latest versions
+
+  $ sudo port sync
+
+Then install ansible
+
+  $ sudo port install ansible