explain why Hypnotoad cannot be configured from the command line

mojolicious · Jan 6, 2016 · e05d05e · e05d05e
1 parent f1abd6f
commit e05d05e
Show file tree

Hide file tree

Showing 2 changed files with 24 additions and 1 deletion.
diff --git a/Changes b/Changes
@@ -1,5 +1,5 @@
 
-6.40  2016-01-06
+6.40  2016-01-07
 
 6.39  2016-01-03
   - Updated links to Mojolicious website.

diff --git a/lib/Mojolicious/Guides/FAQ.pod b/lib/Mojolicious/Guides/FAQ.pod
@@ -147,6 +147,29 @@ detection, or consider using
 L<relaxed placeholders|Mojolicious::Guides::Routing/"Relaxed placeholders"> to
 allow matching of the C<.> character.
 
+=head2 Can i configure Hypnotoad from the comand line?
+
+No, you can't, Hypnotoad is a bit special in this regard. Because when you
+initiate a zero downtime software upgrade (hot deployment), you are only really
+sending a C<USR2> signal to the already running server, and no other information
+can be passed along. But what you can do instead, is to use a
+L<Mojolicious::Plugin::Config> or L<Mojolicious::Plugin::JSONConfig>
+configuration file.
+
+  # myapp.conf
+  {
+    hypnotoad => {
+      listen  => ['http://*:8080'],
+      workers => 10
+    }
+  };
+
+Or if you don't actually need zero downtime software upgrades, you can also just
+use L<Mojolicious::Command::prefork> instead, which is almost identical to
+Hypnotoad.
+
+  $ ./myapp.pl prefork -m production -l http://*:8080 -w 10
+
 =head2 What does the error "Maximum message size exceeded" mean?
 
 To protect your applications from excessively large requests and responses, our