summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md48
1 files changed, 48 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 000000000..6184b6ee3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+# 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.
+
+### 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
+
+* [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
+* [node.js](https://nodejs.org/) for javascript minification
+