Utility to administrate mailserver based on postfix and dovecot
Ruby
Clone or download
iaddict Change /users/:user_name segment to allow _
_ is a valid char for email names and aliases.
Latest commit c399c2a Apr 20, 2018

README.md

#posty_API Build Status

The posty_API is the core element of the posty softwarestack. It is developed to administrate a mailserver based on Postfix and Dovecot. It offers an easy REST interface which can be used in own applications or with the posty client applications, posty_CLI and posty_webUI.

Requirements

You need a working ruby installation.

Tested with ruby 2.1.8, 2.2.4, 2.3.0

Installation

  1. Download the source either using git or from the GitHub page as archive.
  2. Extract the archive
  3. Change directory to the extracted folder
  4. Copy config/database.mysql2.yml or config/database.postgresql.yml to config/database.yml and change it to your needs.
  5. Run bundle install --with mysql for MySQL or bundle install --with postgresql for PostgreSQL
  6. Run rake db:migrate
  7. Run rake api_key:generate
  8. Start the application e.g. with rackup

Notice: Check your RACK_ENV if any problems occur.

Usage

Here is a short overview about the possible API REST calls. Also available at http://www.posty-soft.de/swaggerv2/posty_api.html

Domains:

Users:

UserAliases:

DomainAliases:

Summary:

Transports:

ApiKeys:

:access_token :active :expires_at

Test

You can run the tests by going to project root and run: rspec

Information

For more informations about posty please visit our website: www.posty-soft.org

Support

Bug reports

If you discover any bugs, feel free to create an issue on GitHub. Please add as much information as possible to help us fixing the possible bug. We also encourage you to help even more by forking and sending us a pull request.

License

LGPL v3 license. See LICENSE for details.

Copyright

All rights are at (C) http://www.posty-soft.org 2014