cyberman/README.md

61 lines
2.3 KiB
Markdown
Raw Normal View History

2017-07-14 19:31:58 +02:00
# cyberman
2017-08-13 22:17:59 +02:00
A web-ui for registering domains, written in modern Perl 5 with Dancer.
2017-08-13 22:21:46 +02:00
[issue tracker](https://git.fuwafuwa.moe/.cyb/cyberman/issues) | [detailed documentation](https://http.cat/404)
2017-08-13 22:17:59 +02:00
## Current state
Cyberman was designed to serve .cyb, and the codebase reflects this. Although it is capable of serving any domain, the default config is for .cyb, and the templates/stylesheet are oriented towards cybNIC. We're interested in producing a 'generic' style; if you'd like to contribute to this, do get in touch.
## Features
* Registering domains
* Unregistering domains
## Prerequisites
You need a recent Perl 5 version (5.14 or later should do) and some Perl modules. The best way to get these is to install cpanminus (`cpan App::cpanminus`, `curl https://cpanmin.us | perl - app::cpanminus`, or better still, use your package manager) and then run `cpanm --installdeps .` in the repo directory.
You also need SQLite3. To set up the database:
2017-07-15 18:14:40 +02:00
```
2017-08-13 22:17:59 +02:00
cd /path/to/cyberman
2017-07-15 18:14:40 +02:00
sqlite3 db.sqlite
(sqlite prompt) .read schema.sql
(sqlite prompt) .q
```
2017-08-13 22:17:59 +02:00
## Getting started
Once you've got all that, just run `plackup` to start a development server. You should probably inspect and alter `config.yml` first.
## Production!
You can deploy cyberman however you want, using Plack. Just make sure you pass `-E production` - this disables detailed error pages which could be a security risk, and tones down the logging.
## Questions, fan mail, etc
Feel free to join `#cyb` on `irc.cyberia.is`!
2017-08-20 00:10:54 +02:00
### License
```
Cyberman: Web UI for domain registration
Copyright (C) 2017 "Al Beano" <albino@autistici.org>
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program (see LICENSE file); if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
```