diff --git a/README.md b/README.md
index 3f0f9ea..2e9b361 100644
--- a/README.md
+++ b/README.md
@@ -1,26 +1,33 @@
-# website
+# Website service
 
-a [Sails v1](https://sailsjs.com) application
+The website of The First Spine. A [Sails v1](https://sailsjs.com) application.
 
+## Installation
 
-### Links
+```
+npm ci
+```
 
-+ [Sails framework documentation](https://sailsjs.com/get-started)
-+ [Version notes / upgrading](https://sailsjs.com/documentation/upgrading)
-+ [Deployment tips](https://sailsjs.com/documentation/concepts/deployment)
-+ [Community support options](https://sailsjs.com/support)
-+ [Professional / enterprise options](https://sailsjs.com/enterprise)
+## Running the app
 
+Prefer using the Sails CLI (`npm install sails -g`) to start the application.
 
-### Version info
+```
+sails lift
+```
 
-This app was originally generated on Wed Jan 22 2020 08:34:00 GMT+0100 (Paris, Madrid) using Sails v1.2.3.
+## Build & run for production
 
-<!-- Internally, Sails used [`sails-generate@1.16.13`](https://github.com/balderdashy/sails-generate/tree/v1.16.13/lib/core-generators/new). -->
+```
+npm run start
+```
 
+## Configuration
 
+See the configuration keys with the [Ansible playbook](https://github.com/thefirstspine/ansible/blob/master/volume/playbooks/deploy-website.yaml)
 
-<!--
-Note:  Generators are usually run using the globally-installed `sails` CLI (command-line interface).  This CLI version is _environment-specific_ rather than app-specific, thus over time, as a project's dependencies are upgraded or the project is worked on by different developers on different computers using different versions of Node.js, the Sails dependency in its package.json file may differ from the globally-installed Sails CLI release it was originally generated with.  (Be sure to always check out the relevant [upgrading guides](https://sailsjs.com/upgrading) before upgrading the version of Sails used by your app.  If you're stuck, [get help here](https://sailsjs.com/support).)
--->
+To help you configure your local environment to generate a dotenv file you can use the [configurator](https://github.com/thefirstspine/configurator) using this command:
 
+```
+node configurator.js create website --conf-path [local copy of ansible volume]/conf --force-http true
+```