Add documenatation for building and running

1 files changed, 24 insertions, 0 deletions

diff --git a/README.md b/README.md
index 9d3812e..c79a647 100644
--- a/README.md
+++ b/README.md
@@ -55,6 +55,30 @@ does not need to provide a password.
 Finally you can quit the MariaDB shell with CTRL + d.
 
 
+## Build and run Ceres
+
+If you just cloned the repository it is important to initialize Git submodules
+to add dependencies via `git submodule update --init`.
+
+Then it is time to build and run Ceres for the first time! If your database is
+correctly configured and your current user has access rights, it is very simple
+to run the server in debug mode:
+
+```
+	make debug
+```
+
+In addition you can also build the server executable with `make all`. The
+result is in the build folder and can be run with:
+
+```
+	./build/ceres -c config/debug.json
+```
+
+The used `config/debug.json` config file is only for debugging. If you want to
+run it as a server, have a look at the `config/default.json` file.
+
+
 [1]: https://xengineering.eu/git/ceres
 [2]: ./CHANGELOG.md
 [3]: https://mariadb.com/