diff --git a/docs/recipes/index.md b/docs/recipes/index.md
index 495370798..482a48943 100644
--- a/docs/recipes/index.md
+++ b/docs/recipes/index.md
@@ -33,5 +33,5 @@ At this point, it's assumed that:
 
  * [using Apache as an authenticating proxy](apache.md)
  * [using Nginx as an authenticating proxy](nginx.md)
- * [running a Registry on OS X](osx-setup-guide.md)
+ * [running a Registry on macOS](osx-setup-guide.md)
  * [mirror the Docker Hub](mirror.md)
diff --git a/docs/recipes/menu.md b/docs/recipes/menu.md
index 1755009e2..15398f750 100644
--- a/docs/recipes/menu.md
+++ b/docs/recipes/menu.md
@@ -17,5 +17,5 @@ type: menu
 
  * [using Apache as an authenticating proxy](apache.md)
  * [using Nginx as an authenticating proxy](nginx.md)
- * [running a Registry on OS X](osx-setup-guide.md)
+ * [running a Registry on macOS](osx-setup-guide.md)
  * [mirror the Docker Hub](mirror.md)
diff --git a/docs/recipes/osx-setup-guide.md b/docs/recipes/osx-setup-guide.md
index 0d0c443d5..f926f8c9e 100644
--- a/docs/recipes/osx-setup-guide.md
+++ b/docs/recipes/osx-setup-guide.md
@@ -1,32 +1,32 @@
 ---
-description: Explains how to run a registry on OS X
+description: Explains how to run a registry on macOS
 keywords:
-- registry, on-prem, images, tags, repository, distribution, OS X, recipe, advanced
+- registry, on-prem, images, tags, repository, distribution, macOS, recipe, advanced
 menu:
   main:
     parent: smn_recipes
-title: Running on OS X
+title: Running on macOS
 ---
 
-# OS X Setup Guide
+# macOS Setup Guide
 
 ## Use-case
 
-This is useful if you intend to run a registry server natively on OS X.
+This is useful if you intend to run a registry server natively on macOS.
 
 ### Alternatives
 
-You can start a VM on OS X, and deploy your registry normally as a container using Docker inside that VM.
+You can start a VM on macOS, and deploy your registry normally as a container using Docker inside that VM.
 
 The simplest road to get there is traditionally to use the [docker Toolbox](https://www.docker.com/toolbox), or [docker-machine](/machine/index.md), which usually relies on the [boot2docker](http://boot2docker.io/) iso inside a VirtualBox VM.
 
 ### Solution
 
-Using the method described here, you install and compile your own from the git repository and run it as an OS X agent.
+Using the method described here, you install and compile your own from the git repository and run it as an macOS agent.
 
 ### Gotchas
 
-Production services operation on OS X is out of scope of this document. Be sure you understand well these aspects before considering going to production with this.
+Production services operation on macOS is out of scope of this document. Be sure you understand well these aspects before considering going to production with this.
 
 ## Setup golang on your machine