Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 40 lines (28 sloc) 1.376 kb
61e27b1 Sam Stephenson Begin work on the manual
sstephenson authored
1 Pow: Zero-configuration Rack server for Mac OS X
2 ================================================
3
4 **Pow is a zero-configuration Rack server for Mac OS X.** It makes
5 developing Rails and Rack applications _stupid easy_. You can install
6 it in ten seconds and have your first app up and running in under a
7 minute. No mucking around with `/etc/hosts`, no compiling Apache
8 modules, no editing configuration files or installing preference
9 panes. And running multiple apps with multiple versions of Ruby is
10 trivial.
11
12 How does it work? A few simple conventions eliminate the need for
13 tedious configuration. Pow runs as your user on an unprivileged port,
14 and includes both an HTTP and a DNS server. The installation process
15 sets up a firewall rule to forward incoming requests on port 80 to
16 Pow. It also sets up a system hook so that all DNS queries for a
17 special top-level domain (`.test`) resolve to your local machine.
18
19 To serve a Rack app, just symlink it into your `~/.pow`
20 directory. Let's say you're working on an app that lives in
21 `~/Projects/myapp`. You'd like to access it at
22 `http://myapp.test/`. Setting it up is as easy as:
23
24 $ cd ~/.pow
25 $ ln -s ~/Projects/myapp
26
27 That's it! The name of the symlink determines the hostname you use to
28 access the application it points to.
29
30 ## Installation
31
32 ## Managing Applications
33
34 ## Troubleshooting
35
36 ## Contributing
37
38 ## License
39
Something went wrong with that request. Please try again.