1 files changed, 54 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 000000000..696f5ce6c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,54 @@
+# FileBin
+
+A pastebin software running on [https://paste.xinu.at](https://paste.xinu.at).
+In addition to uploading text and code it also supports binary files.
+
+Additional documentation can be found in [`./doc`](doc/).
+
+## Installation/Development
+
+Git is used for tracking changes and updating installations. The repository is
+located at [https://git.server-speed.net/users/flo/filebin/](https://git.server-speed.net/users/flo/filebin/).
+Clone the repository and follow the instructions in `./INSTALL`. Do not
+install using tarballs as this is not supported.
+
+`dev` is the development branch and should not be used in production. All
+stable changes go to `master` and will be tagged regularly following [semver
+guidelines](http://semver.org/).
+
+### Mailing List
+
+Currently there is only [one mailing
+list](https://lists.server-speed.net/listinfo/filebin-general) for everything
+(general discussion, patches, announcements, ...). If need be more lists will be
+created at a later date.
+
+### IRC
+
+The official IRC channel is [irc.freenode.net/#filebin](irc://irc.freenode.net/#filebin).
+
+### Patches
+
+Please submit patches (preferably git send-email) to the [filebin-general
+mailing list](https://lists.server-speed.net/listinfo/filebin-general). You do
+not need to register to be allowed to post.
+
+You can also open a pull request on [GitHub](https://github.com/Bluewind/filebin).
+
+
+## Dependencies
+
+*  PHP >=5.5 with the following modules
+    * gd for thumbnail generation
+    * exif for thumbnail generation
+    * phar for tarball creation
+    * mysql, mysqli, pgsql, pdo_mysql (any of those) for database access
+	* xdebug for tests (not required on production)
+
+*  [composer](https://getcomposer.org/) for dependency management
+*  [pygmentize](http://pygments.org/) for code highlighting
+*  [ansi2html](http://pypi.python.org/pypi/ansi2html) for shell output rendering (ANSI color codes)
+*  [imagemagick](http://www.imagemagick.org/) for additional thumbnail generation
+	* ghostscript for PDF thumbnail creation via imagemagick
+*  [node.js](https://nodejs.org/) for javascript minification
+