service/README.md

56 lines
1.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

`service` is a tool that deploys and manages dæmons and services.
## Dependencies
Youll 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, youll 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
```