Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 114 lines (97 sloc) 4.76 kb
2d5a4b0 doc: emphasize the importance of stderr_path
Eric Wong authored
1 # Sample verbose configuration file for Unicorn (not Rack)
2 #
3 # This configuration file documents many features of Unicorn
4 # that may not be needed for some applications. See
5 # http://unicorn.bogomips.org/examples/unicorn.conf.minimal.rb
6 # for a much simpler configuration file.
253f0ab Add examples for nginx and unicorn
Eric Wong authored
7 #
8 # See http://unicorn.bogomips.org/Unicorn/Configurator.html for complete
9 # documentation.
10
11 # Use at least one worker per core if you're on a dedicated server,
12 # more will usually help for _short_ waits on databases/caches.
13 worker_processes 4
14
c4d3cd7 @emmanuel Document "user" directive in example unicorn conf
emmanuel authored
15 # Since Unicorn is never exposed to outside clients, it does not need to
16 # run on the standard HTTP port (80), there is no reason to start Unicorn
17 # as root unless it's from system init scripts.
18 # If running the master process as root and the workers as an unprivileged
19 # user, do this to switch euid/egid in the workers (also chowns logs):
20 # user "unprivileged_user", "unprivileged_group"
21
253f0ab Add examples for nginx and unicorn
Eric Wong authored
22 # Help ensure your application will always spawn in the symlinked
23 # "current" directory that Capistrano sets up.
24 working_directory "/path/to/app/current" # available in 0.94.0+
25
26 # listen on both a Unix domain socket and a TCP port,
27 # we use a shorter backlog for quicker failover when busy
9f846a2 doc: update documentation for systemd + PrivateTmp users
Eric Wong authored
28 listen "/path/to/.unicorn.sock", :backlog => 64
253f0ab Add examples for nginx and unicorn
Eric Wong authored
29 listen 8080, :tcp_nopush => true
30
31 # nuke workers after 30 seconds instead of 60 seconds (the default)
32 timeout 30
33
34 # feel free to point this anywhere accessible on the filesystem
35 pid "/path/to/app/shared/pids/unicorn.pid"
36
2d5a4b0 doc: emphasize the importance of stderr_path
Eric Wong authored
37 # By default, the Unicorn logger will write to stderr.
38 # Additionally, ome applications/frameworks log to stderr or stdout,
39 # so prevent them from going to /dev/null when daemonized here:
253f0ab Add examples for nginx and unicorn
Eric Wong authored
40 stderr_path "/path/to/app/shared/log/unicorn.stderr.log"
41 stdout_path "/path/to/app/shared/log/unicorn.stdout.log"
42
8478a54 doc: update doc for Ruby 2.0.0dev CoW-friendliness
Eric Wong authored
43 # combine Ruby 2.0.0dev or REE with "preload_app true" for memory savings
253f0ab Add examples for nginx and unicorn
Eric Wong authored
44 # http://rubyenterpriseedition.com/faq.html#adapt_apps_for_cow
45 preload_app true
46 GC.respond_to?(:copy_on_write_friendly=) and
47 GC.copy_on_write_friendly = true
48
5c700fc @boourns Begin writing HTTP request headers early to detect disconnected clients
boourns authored
49 # Enable this flag to have unicorn test client connections by writing the
50 # beginning of the HTTP headers before calling the application. This
51 # prevents calling the application for connections that have disconnected
90db7b1 check_client_connection: document local-only requirement
Eric Wong authored
52 # while queued. This is only guaranteed to detect clients on the same
53 # host unicorn runs on, and unlikely to detect disconnects even on a
54 # fast LAN.
5c700fc @boourns Begin writing HTTP request headers early to detect disconnected clients
boourns authored
55 check_client_connection false
56
3318b07 examples: add run_once to before_fork hook example
Eric Wong authored
57 # local variable to guard against running a hook multiple times
58 run_once = true
59
253f0ab Add examples for nginx and unicorn
Eric Wong authored
60 before_fork do |server, worker|
61 # the following is highly recomended for Rails + "preload_app true"
62 # as there's no need for the master process to hold a connection
63 defined?(ActiveRecord::Base) and
64 ActiveRecord::Base.connection.disconnect!
65
3318b07 examples: add run_once to before_fork hook example
Eric Wong authored
66 # Occasionally, it may be necessary to run non-idempotent code in the
67 # master before forking. Keep in mind the above disconnect! example
68 # is idempotent and does not need a guard.
69 if run_once
70 # do_something_once_here ...
71 run_once = false # prevent from firing again
72 end
73
253f0ab Add examples for nginx and unicorn
Eric Wong authored
74 # The following is only recommended for memory/DB-constrained
75 # installations. It is not needed if your system can house
76 # twice as many worker_processes as you have configured.
77 #
78 # # This allows a new master process to incrementally
79 # # phase out the old master process with SIGTTOU to avoid a
80 # # thundering herd (especially in the "preload_app false" case)
81 # # when doing a transparent upgrade. The last worker spawned
82 # # will then kill off the old master process with a SIGQUIT.
83 # old_pid = "#{server.config[:pid]}.oldbin"
84 # if old_pid != server.pid
85 # begin
86 # sig = (worker.nr + 1) >= server.worker_processes ? :QUIT : :TTOU
87 # Process.kill(sig, File.read(old_pid).to_i)
88 # rescue Errno::ENOENT, Errno::ESRCH
89 # end
90 # end
91 #
4d493d8 examples/unicorn.conf: add a note about throttling signals
Eric Wong authored
92 # Throttle the master from forking too quickly by sleeping. Due
93 # to the implementation of standard Unix signal handlers, this
94 # helps (but does not completely) prevent identical, repeated signals
95 # from being lost when the receiving process is busy.
253f0ab Add examples for nginx and unicorn
Eric Wong authored
96 # sleep 1
97 end
98
99 after_fork do |server, worker|
100 # per-process listener ports for debugging/admin/migrations
101 # addr = "127.0.0.1:#{9293 + worker.nr}"
102 # server.listen(addr, :tries => -1, :delay => 5, :tcp_nopush => true)
103
104 # the following is *required* for Rails + "preload_app true",
105 defined?(ActiveRecord::Base) and
106 ActiveRecord::Base.establish_connection
107
108 # if preload_app is true, then you may also want to check and
109 # restart any other shared sockets/descriptors such as Memcached,
110 # and Redis. TokyoCabinet file handles are safe to reuse
111 # between any number of forked children (assuming your kernel
112 # correctly implements pread()/pwrite() system calls)
113 end
Something went wrong with that request. Please try again.