From 86a76a81d88167c3e6181eb2934c09a9cb521d36 Mon Sep 17 00:00:00 2001
From: Robert Sesek <rsesek@bluestatic.org>
Date: Sun, 12 Aug 2012 14:39:25 -0400
Subject: [PATCH] Create a README file

---
 README.md | 86 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 86 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e899cce
--- /dev/null
+++ b/README.md
@@ -0,0 +1,86 @@
+# Armadillo File Manager
+
+Armadillo is a web-based file manager. It allows you to list, move, rename,
+delete, and download files through your browser. It's the ideal solution for a
+home media center, allowing you to manage your files from your couch.
+
+## Installation
+
+Installation requires the [Go runtime](http://golang.org/doc/install) because
+there is no binary distribution yet.
+
+After installing Go, clone this repository and type `make`:
+
+    $ git clone https://github.com/rsesek/armadillo
+    $ make
+
+    # Or to minify the JavaScript:
+
+    $ make release
+
+If you have Java installed, you can use the
+[Closure Compiler](https://developers.google.com/closure/compiler/) to minify
+and compile the frontend JavaScript code by typing `make release`.
+
+After building, you will have a binary named `armadillo`.
+
+## Configuration
+
+Armadillo can either be configured using command line parameters, or via a JSON
+configuration file in `~/.armadillo`. The two important directives are
+"JailRoot" and "Port":
+
+    {
+      # No operations will be performed outside of this directory. Everything in
+      # this directory and below will be served by Armadillo.
+      "JailRoot": "/path/to/root",
+
+      # The port on which to run Armadillo.
+      "Port": 8084
+    }
+
+You can specify these values on the command line. See `armadillo -help` for
+more details.
+
+## Security
+
+Armadillo does not fork itself into a daemon process; it runs under the user
+who started t. This is because it needs read and write permission to the file
+system.
+
+**NOTE: Armadillo provides no form of authorization or authentication. It is
+recommended to either only run it on your local network, or to place it behind
+a reverse web proxy like [nginx](http://nginx.org) or
+[Apache](http://httpd.apache.org) to provide security.** Configuring those
+servers is beyond the scope of this document.
+
+## Running
+
+On Mac OS X, the recommended way to start Armadillo on launch is to use
+launchd. Create a file called
+`~/Library/LaunchAgents/org.bluestatic.armadillo.plist` with this content:
+
+    <?xml version="1.0" encoding="UTF-8"?>
+    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+    <plist version="1.0">
+    <dict>
+            <key>Label</key>
+            <string>org.bluestatic.armadillo</string>
+            <key>ProgramArguments</key>
+            <array>
+                    <string>/Users/your_name/Projects/armadillo/armadillo</string>
+                    <string>-config=/path/to/config.json</string>
+            </array>
+            <key>KeepAlive</key>
+            <false/>
+            <key>RunAtLoad</key>
+            <true/>
+    </dict>
+    </plist>
+
+Then type:
+
+    launchctl load ~/Library/LaunchAgents/org.bluestatic.armadillo.plist
+
+And armadillo will start serving with the configuration file you specified in
+the plist. The next time you log in, armadillo will run automatically.
-- 
2.22.5