PhpDev.App
kalkun-sms/Kalkun

kalkun-sms/Kalkun

Stars: 194

Forks: 131

Pull Requests: 278

Issues: 223

Watchers: 29

Last Updated: 2023-09-09 15:07:42

Open Source Web based SMS Manager

License: GNU General Public License v3.0

Languages: PHP, HTML, JavaScript, CSS, Shell, Batchfile

https://kalkun.sourceforge.io/

Kalkun - Open Source Web-based SMS Manager

Kalkun is an open source web-based SMS (Short Message Service) manager. It uses gammu-smsd (part of gammu family) as SMS gateway engine to deliver and retrieve messages from your phone/modem.

Features

Requirements

For full details, see the requirements on the wiki.

Briefly, this is what has to be installed & configured prior to installing Kalkun:

  • HTTP Server (any of Apache httpd, Lighttpd, NGINX, IIS...)
  • Composer (Dependency Manager for PHP)
  • PHP >=5.6, >=7, >=8
  • PHP-CLI (command line interface)
  • PHP extensions (composer should tell you which ones are missing on your system)
  • MySQL/MariadDB 5.5.3+ (having full UTF-8 support) or PostgreSQL or SQLite3
  • Gammu SMSD (make sure it is already running and configured)

Installation

You can find detailed installation instructions on the wiki.

There are also Debian & derivatives (Ubuntu...) packages produced for releases and snapshots on every commit. Detailed installation instructions to use the Debian package are on the wiki.

Brief installation steps

Find the detailed installation steps on the wiki.

If you are upgrading, check the Release notes.

Steps in brief:

  1. Extract to web root folder (eg: /var/www/html => Ubuntu)
  2. Run composer install from there to get & check the dependencies.
  3. Create the gammu smsd database.
    • Kalkun uses the database that is created by gammu with all the tables created by gammu. Kalkun then adds tables and some columns. So there is no such case where one has a gammu database separate from the kalkun database. Both software share the same database.
  4. Import gammu database schema (it's included on gammu sources, eg. gammu/docs/sql/mysql.sql).
  5. Configure Kalkun daemon & outbox_queue scripts (to manage inbox and autoreply)
  6. Optionally: increase the security of your installation
  7. Configure the connection to the database in application/config/database.php
  8. Launch the install wizard of Kalkun, preferably by going to http://localhost/kalkun/index.php/install
  9. Delete the installation file (the install wizard tell you where it is, if this step is needed)
  10. Change the default encryption key in application/config/config.php
  11. Launch Kalkun by browsing to http://localhost/kalkun. Default login and password are kalkun.

Contributing

Please check the wiki contribution suggestions.

Documentation

See the documentation on the Wiki

License

Kalkun is licensed under GPL-3-or-later.

OPEN ISSUES

See all