GitBook: [master] 6 pages modified

Author: toastercup

README.md

@@ -4,7 +4,7 @@ Cortex [CMS](glossary.md#cms) is a [multitenant](https://en.wikipedia.org/wiki/M
 
 Cortex adheres to a headless, API-only architecture - it avoids a monolithic, all-in-one architecture associated with CMSs like WordPress or Drupal.
 
-To jump straight into using Cortex CMS, please refer to the [manual setup guide](basics/setup/manual-setup.md).
+To jump straight into using Cortex CMS, please refer to either the [Docker Compose guide](basics/setup/docker-compose.md) \(recommended\) or the [manual setup guide](basics/setup/manual-setup.md).
 
 [![CircleCI](https://circleci.com/gh/cortex-cms/cortex.svg?style=svg)](https://circleci.com/gh/cortex-cms/cortex) ![Code Climate](https://codeclimate.com/repos/53f62c2869568018180036c9/badges/78e3c3c865b118bbd72b/gpa.svg) ![Test Coverage](https://codeclimate.com/repos/53f62c2869568018180036c9/badges/78e3c3c865b118bbd72b/coverage.svg)
 

SUMMARY.md

@@ -7,6 +7,7 @@
 * [Examples](examples.md)
 * [Basics](basics/README.md)
   * [Setup](basics/setup/README.md)
+    * [Docker Compose](basics/setup/docker-compose.md)
     * [Manual Setup](basics/setup/manual-setup.md)
     * [Core & Plugin Development](basics/setup/core-and-plugin-development.md)
   * [Deployment](basics/deployment.md)

basics/README.md

@@ -3,9 +3,9 @@
 Working with Cortex CMS as a [superadministrator](../glossary.md#superadministrator) may seem daunting at first blush, but we're here to walk you through every step and demonstrate the simplicity & power of the platform.
 
 * [Setup](https://github.com/cortex-cms/cortex-cms/tree/ec0acc5e822e7cd071403cac968f82e8f6df4a96/basics/setup.md)
+  * [Docker Compose](https://docs.cortexcms.org/basics/setup/docker-compose)
   * [Manual](setup/manual-setup.md)
   * [Core & Plugin Development](setup/core-and-plugin-development.md)
-  * Docker Compose _\(coming soon\)_
   * Engine Mounting _\(coming soon\)_
 * [Deployment](deployment.md)
 * [Tenancy & User Management](tenancy-and-user-management.md)

basics/setup/README.md

@@ -2,10 +2,8 @@
 
 If you're interested in local development with Cortex \(relevant to [integration engineers](../../glossary.md#integration-engineer), or those who wish to contribute to the project\), these guides will walk you through the process across any POSIX OS.
 
+* [Docker Compose](docker-compose.md)
 * [Manual](manual-setup.md)
 * [Core & Plugin Development](core-and-plugin-development.md)
-* Docker Compose _\(coming soon\)_
 * Engine Mounting _\(coming soon\)_
 
-
-

basics/setup/docker-compose.md

@@ -0,0 +1,31 @@
+---
+description: >-
+  Docker Compose automates the configuration, provisioning and execution of
+  Cortex CMS on a single machine. Follow this guide to quickly get started with
+  Cortex CMS.
+---
+
+# Docker Compose
+
+## Environment Preparation
+
+Install `docker` and `docker-compose` using the [installer](https://docs.docker.com/compose/install/#install-compose) or via your Operating System's package manager \(`pacman`, for example\), then launch the service.
+
+## `cortex-starter` Preparation {#cortex-starter-prep}
+
+As `cortex` itself is only a Rails Engine, it needs to be mounted within a parent Rails applicaton. [cortex-starter](https://github.com/cortex-cms/cortex-starter) serves as a starting point for new users, with `cortex` and `cortex-plugins-core` already mounted and configured with several example `ContentTypes`/`Decorators`. Start by cloning the repository:
+
+```bash
+$ git clone git@github.com:cortex-cms/cortex-starter.git && cd cortex-starter
+```
+
+## Provision & Launch Server
+
+Provision and launch Cortex Starter, PostgreSQL, Redis, ElasticSearch, Sidekiq and live Webpack rebuild via Docker Compose:
+
+```bash
+$ docker-compose up
+```
+
+Once complete, the admin interface will be accessible locally at `http://localhost:3000`. To access Cortex CMS as superadmin, login as `admin@cortexcms.org` with password `welcome1`.
+

basics/setup/manual-setup.md

@@ -1,6 +1,6 @@
 # Manual Setup
 
-## `cortex-starter` Prep
+## `cortex-starter` Preparation
 
 As `cortex` itself is only a Rails Engine, it needs to be mounted within a parent Rails applicaton. [cortex-starter](https://github.com/cortex-cms/cortex-starter) serves as a starting point for new users, with `cortex` and `cortex-plugins-core` already mounted and configured with several example `ContentTypes`/`Decorators`. Start by cloning the repository:
 
@@ -21,7 +21,7 @@ For a rudimentary setup, these variables should be configured:
 
 ### System
 
-#### OS X
+#### macOS
 
 * Install the Xcode Command Line tools:
 
@@ -128,5 +128,5 @@ Start Cortex, Sidekiq and live Webpack rebuild via Foreman with the `dev-server`
 $ bin/dev-server
 ```
 
-The admin interface should now be accessible locally on port `3000`. To access Cortex as superadmin, login as `admin@cortexcms.org` with password `welcome1`.
+The admin interface should now be accessible locally at `http://localhost:3000`. To access Cortex as superadmin, login as `admin@cortexcms.org` with password `welcome1`.