diff --git a/akka-docs/intro/getting-started-first-java.rst b/akka-docs/intro/getting-started-first-java.rst
index 19ede63b18..5f45a51528 100644
--- a/akka-docs/intro/getting-started-first-java.rst
+++ b/akka-docs/intro/getting-started-first-java.rst
@@ -397,6 +397,18 @@ When this in done we can run our application directly inside Maven::
 
 Yippee! It is working.
 
+Overriding Configuration Externally
+-----------------------------------
+
+The sample project includes an ``application.conf`` file in the resources directory:
+
+.. includecode:: ../../akka-tutorials/akka-tutorial-first/src/main/resources/application.conf
+
+If you uncomment the two lines, you should see a change in performance,
+hopefully for the better. It should be noted that overriding only works if a
+router type is given, so just uncommenting ``nr-of-instances`` does not work;
+see :ref:`routing-java` for more details.
+
 Conclusion
 ----------
 
diff --git a/akka-docs/intro/getting-started-first-scala.rst b/akka-docs/intro/getting-started-first-scala.rst
index 8f5fb40243..10386ca334 100644
--- a/akka-docs/intro/getting-started-first-scala.rst
+++ b/akka-docs/intro/getting-started-first-scala.rst
@@ -442,6 +442,18 @@ When this in done we can run our application directly inside SBT::
 
 Yippee! It is working.
 
+Overriding Configuration Externally
+===================================
+
+The sample project includes an ``application.conf`` file in the resources directory:
+
+.. includecode:: ../../akka-tutorials/akka-tutorial-first/src/main/resources/application.conf
+
+If you uncomment the two lines, you should see a change in performance,
+hopefully for the better. It should be noted that overriding only works if a
+router type is given, so just uncommenting ``nr-of-instances`` does not work;
+see :ref:`routing-scala` for more details.
+
 Conclusion
 ==========
 
diff --git a/akka-tutorials/akka-tutorial-first/src/main/resources/application.conf b/akka-tutorials/akka-tutorial-first/src/main/resources/application.conf
new file mode 100644
index 0000000000..0a2509357e
--- /dev/null
+++ b/akka-tutorials/akka-tutorial-first/src/main/resources/application.conf
@@ -0,0 +1,7 @@
+akka.actor.deployment {
+  /master/workerRouter {
+    # Uncomment the following two lines to change the calculation to use 10 workers instead of 4:
+    #router = round-robin
+    #nr-of-instances = 10
+  }
+}