From 8e03e83f8d7b987e9b58f4ebdc2c18d50e8aeed5 Mon Sep 17 00:00:00 2001 From: Luka Vandervelden Date: Mon, 18 Nov 2019 16:52:23 +0100 Subject: [PATCH] Primitive README added. --- README.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..6293ea0 --- /dev/null +++ b/README.md @@ -0,0 +1,55 @@ + +`service` is a tool that deploys and manages dæmons and services. + +## Dependencies + +You’ll need `crystal` and `make` to build the application, and `shards` to fetch a few Crystal libraries. + +Run `shards install` to fetch the Crystal libraries. + +## Building + +`service` uses a `build.zsh`-generated Makefile. +You can run `make help` to get a list of all available build targets (“make commands”). + +```sh +make help +``` + +To build and install the software with default configuration, run the following: + +```sh +make +make install +``` + +If you want to alter the installation prefix or destination, use the following syntax: + +```sh +make PREFIX=/usr DESTDIR=/some/fake/root install +``` + +If `make` complains that the Makefile is missing, you’ll have to generate it with the following command: + +```sh +build.zsh +``` + +## Usage + +Read `service.1` and `service.7` for more informations about how `service` is meant to be used. + +## Quickstart + +```sh +service add postgresql +service add gitea domain=gitea.test + +service start postgresql + +service show gitea +service status -v +service status -v gitea +``` + +