This is an old revision of the document!
Table of Contents
Projects of the vpsFree.cz Association
All projects are available in the form of Git repositories on https://git.vpsfree.cz and mirrored on GitHub.
In order to organize development, bug reports and idea collection, we have a Redmine, see where to report bugs and send ideas.
vpsFree.cz
| Repository | Description |
|---|---|
| web | The www.vpsfree.cz website. |
| vpsfree-client | A client for https://api.vpsfree.cz. |
| build-vpsfree-templates | Scripts used to generate templates of distributions. |
| salt-configuration | Physical server configuration. |
| vpsfree-irc-bot | An IRC bot on our channel. |
HaveAPI
HaveAPI is a framework used for the creation of self-documenting RESTful APIs, which was originally created for the vpsAdmin API. However, it is a separate project. Thanks to the ability of the API to self-document, generic clients that do not need to know anything about the API beforehand can be used to communicate with such an API.
| Repository | Description |
|---|---|
| haveapi | A framework for the implementation of API servers in Ruby. |
| haveapi-client | A client library and CLI in Ruby. |
| haveapi-client-php | A client library in PHP. |
| haveapi-client-js | A client library in JavaScript. |
| haveapi-webui | A generic web interface. |
| haveapi-fs | A file system based on FUSE. |
| haveapi-dokuwifi | Authentication plugin for DokuWiki. |
vpsAdmin
vpsAdmin is an interface used to manage physical servers as well as virtual servers and drive storages and other related things running on them. VpsAdmin was developed in order to meet the needs of the vpsFree.cz association and in the future we would also like to see it running outside of our infrastructure.
| Repository | Description | URL |
|---|---|---|
| vpsadmin-api | RESTful API based on HaveAPI, the framework used to create vpsAdmin. | https://api.vpsfree.cz |
| vpsadmind | A daemon running on all physical servers in a cluster | |
| vpsadmindctl | A CLI utility used to control vpsadmind. | |
| vpsadmin-webui | A web interface for the API based on HaveAPI clients. | https://vpsadmin.vpsfree.cz |
| vpsadmin-client | haveapi-client adapted to the vpsAdmin API. | |
| vpsadmin-doc | vpsAdmin documentation. | https://projects.vpsfree.cz/vpsadmin-doc/ |
| vpsadmin-download-mounter | Enables downloading backups of all servers from one place. | |
| vpsadmin-console-router | A router between clients and the backend for a remote console. | |
| vpsadmin-mail-templates | Auxiliary scripts used to generate and install email templates. | |
| vpsadmin-plugin-newslog | Plugin enabling admins to add news/event log. | |
| vpsadmin-plugin-payments | Plugin adding support for paying users. | |
| vpsadmin-plugin-requests | Plugin adding support for user requests. | |
| vpsadmin-plugin-webui | Support plugin for the web UI. | |
| vpsadmin-project-manager | Bulk management of all vpsAdmin repositories. | |
| vpsadmin-vpsfree | A vpsAdmin configuration specific to vpsFree.cz. | |
| vpsadmininstall | An old vpsAdmin installer, currently not working. |
Other
| Repository | Description |
|---|---|
| spl | A fork of https://github.com/zfsonlinux/spl |
| zfs | A fork of https://github.com/zfsonlinux/zfs |
| vzctl | A fork of vzctl supporting several distributions and a remote console. |
Hosted services
| Service | Description | URL |
|---|---|---|
| IRC bouncer | See bouncer | https://im.vpsfree.cz/znc/ |
| Paste service | Service for pasting code snippets or program outputs | https://paste.vpsfree.cz |
How to contribute
You can either attach patches to requests in Redmine, or you can make a pull request on GitHub
Page Tools
