diff --git a/README.md b/README.md
index 35b9411..b12b3c4 100644
--- a/README.md
+++ b/README.md
@@ -2,70 +2,197 @@
> A database-driven Greenlock storage plugin with wildcard support.
+## Features
+
+* Many [Supported SQL Databases](http://docs.sequelizejs.com/manual/getting-started.html)
+ * [x] PostgreSQL (**best**)
+ * [x] SQLite3 (**easiest**)
+ * [x] Microsoft SQL Server (mssql)
+ * [x] MySQL, MariaDB
+* Works on all platforms
+ * [x] Mac, Linux, VPS
+ * [x] AWS, Heroku, Akkeris, Docker
+ * [x] Windows
+
## Usage
-To use, provide this Greenlock storage plugin as the `store` attribute when you
-invoke `create`.
+To use, provide this Greenlock storage plugin as the `store` option when you
+invoke `create`:
```js
-greenlock.create({
- store: require('le-store-sequelize')
+Greenlock.create({
+ store: require('greenlock-store-sequelize')
+ ...
});
```
## Configuration
-### Defaults
+SQLite3 (default)
-No configuration is required. By default, you'll get a baked-in Sequelize
-database running [sqlite3](https://www.npmjs.com/package/sqlite3).
+SQLite3 is the default database, however, since it has a large number of dependencies
+and may require a native module to be built, you must explicitly install
+[sqlite3](https://www.npmjs.com/package/sqlite3):
-### Database Connection
+```bash
+npm install --save sqlite3
+```
-Without `config.dbOptions`, the baked-in sequelize object uses sqlite3 with
-defaults. If `config.dbOptions` is provided, you can configure the database
-connection per the Sequelize documentation.
+The default db file will be written wherever Greenlock's `configDir` is set to,
+which is probably `~/acme` or `~/letsencrypt`.
-If a dialect other than sqlite3 is used, dependencies will need to be
-installed.
+```bash
+~/acme/db.sqlite3
+```
-```javascript
-greenlock.create({
- store: require('le-store-sequelize')({
- dbConfig: {
- username: 'mysqluser',
- password: 'mysqlpassword',
- database: 'mysqldatabase,
- host: '127.0.0.1',
- dialect: 'mysql'
+If you wish to set special options you may do so by passing a pre-configured `Sequelize` instance:
+
+```js
+var Sequelize = require('sequelize');
+var db = new Sequelize({ dialect: 'sqlite', storage: '/Users/me/acme/db.sqlite3' });
+
+Greenlock.create({
+ store: require('greenlock-store-sequelize').create({ db: db })
+ ...
+});
+```
+PostgreSQL, SQL Server, and lesser databases...
+
+The general format of a DATABASE_URL is something like this:
+
+> `schema://user:pass@server:port/service?option=foo`
+
+For example:
+
+> `postgres://aj:secret123@127.0.0.1:5432/greenlock`
+
+For each database the exact format may be slightly different:
+
+* `postgres://user:pass@hostname:port/database?option=foo`
+* `sqlserver://user:pass@datasource:port/instance/catalog?database=dbname` (mssql)
+* `mysql://user:pass@hostname:port/database?option=foo`
+* `mariadb://user:pass@hostname:port/database?option=foo`
+
+There's also a way to specify objects instead of using the standard connection strings.
+
+See the next section for more information.
+Database URLs / Connection Strings
+You may use database URLs (also known as 'connection strings') to initialize sequelize:
+
+```js
+var dbUrl = 'postgres://user:pass@hostname:port/database';
+
+Greenlock.create({
+ store: require('greenlock-store-sequelize').create({ storeDatabaseUrl: dbUrl })
+ ...
+});
+```
+
+If you need to use **custom options**, just instantiate sequelize directly:
+
+```js
+var Sequelize = require('sequelize');
+var db = new Sequelize('postgres://user:pass@hostname:port/database');
+
+Greenlock.create({
+ store: require('greenlock-store-sequelize').create({ db: db })
+ ...
+});
+```
+
+See the [Sequelize Getting Started](http://docs.sequelizejs.com/manual/getting-started.html) docs for more info
+on database options for sequelize.
+Environment variables (AWS, Docker, Heroku, Akkeris)
+If your database connection string is in an environment variable,
+you would use the usual standard for your platform.
+
+For example, if you're using Heroku, Akkeris, or Docker you're
+database connection string is probably `DATABASE_URL`, so you'd do something like this:
+
+```js
+var Sequelize = require('sequelize');
+var databaseUrl = process.env['DATABASE_URL'];
+var db = new Sequelize(databaseUrl);
+
+Greenlock.create({
+ store: require('greenlock-store-sequelize').create({ db: db })
+ ...
+});
+```
+Table Prefixes
+The default table names are as follows:
+
+* Keypair
+* Domain
+* Certificate
+* Chain
+
+If you'd like to add a table name prefix or define a specific schema within the database (PostgreSQL, SQL Server),
+you can do so like this:
+
+```js
+var Sequelize = require('sequelize');
+var databaseUrl = process.env['DATABASE_URL'];
+var db = new Sequelize(databaseUrl, {
+ hooks: {
+ beforeDefine: function (columns, model) {
+ model.tableName = 'MyPrefix' + model.name.plural;
+ //model.schema = 'public';
+ }
}
- })
+});
+
+Greenlock.create({
+ store: require('greenlock-store-sequelize').create({ db: db })
+ ...
});
```
+