Main Page

From FreeSWITCH Wiki
Jump to: navigation, search

Help us convert these wiki pages to confluence, email wking@freeswitch.org for an account on the sandbox, FreeSWITCH Confluence.


Welcome to the community documentation wiki for FreeSWITCH, a telephony construction kit for building everything from softphones to full Class 5 switches. You can embed FreeSWITCH into a soft- (or hard-) phone or OpenWRT router, hook it to PRI circuits through FreeTDM and hardware interfaces such as the Sangoma A100 line, or use it to build an office PBX phone system -- from scratch, or using packaged add-ons like FusionPBX.

Contents

FreeSWITCH has a large and active development community, mailing lists and an IRC channel, an annual convention, and more. It's licensed under the MPL; the Mozilla Public License.

Which version should I use?

Executive summary: deploy stable for production systems, master for test and development systems.

The stable 1.2 series is recommended for production use. This is available in Git but also as a tarball. Although the tarball has the latest official stable release, there may be more recent patches to the stable branch in the v1.2.stable Git branch, therefore Git is still the recommended option.

The stable 1.2 series is available in Git branch v1.2.stable. Patches to the 1.2 series will be made here and periodically released as the next 1.2.x version. Since not every patch will mean a newer version you will get the very latest patches to the stable series by using this branch. This branch is a moving target - the checkout date and revision will form part of the version number.

The current stable release in a tarball of FreeSWITCH is 1.2.23, released on 19-Mar-2014. Older releases and other files are in the archive, along with digital signatures that you can use to verify your download.

If you wish to try an even newer experimental version you can use the Master branch from Git. New features will only be added to the Master branch. This will have the newest, latest, and greatest features, but due to upgrading of the bundled libraries it might be less stable than v1.2.stable for a short while. If you use this branch you should test the installation before releasing it to production use to confirm that it is stable in your environment. You can then use 'git checkout' to install the same tested revision on all your systems.

NOTE that this is a formal change of development practice; Master used to be the recommended deployment target for all users, but now the tarballs and the Git stable branch serve that purpose. Older documentation/tutorials may still exist recommending using Master, but these will now be out-of-date.

Any previous 1.0 release (e.g. 1.0.4, 1.0.6) is now ancient and will contain a range of bugs that have since been resolved in newer releases, so you should seriously consider upgrading to 1.2 stable.

When upgrading please review the Release Notes page to see whether there are any behavior changes since previous versions.


See the Download & Installation Guide.

If you'd like to see an overview of the features & fixes in the stable versions click here.

Documentation

New Users - Start Here

Weekly Conference Calls

Upcoming call - Wednesday, October 16th, 2013 (Conf Call Main Page)

Application Examples

  • Gino's Pizza: Uses PocketSphinx, an open source speech recognition engine developed by Carnegie Mellon.
  • JavaScript Conference IVR: Advanced custom implementation of FreeSWITCH conferencing features using JavaScript.
  • Ham Radio Integration: Interfacing radio devices to FreeSWITCH (ham, commercial and unlicensed)
  • PBXMate Integration: Integrating with SoliCall's PBXMate to improve audio quality.

FreeSWITCH™ Architecture

Feature Documentation

Contributing to FreeSWITCH™

FreeSWITCH™ is run by a non-profit corporation OSTAG, the Open Source Telephony Advancement Group. FreeSWITCH™ is made possible through donations from corporations and individuals alike. Donations help keep the project going. You can donate by clicking the donate button on the left.

Documentation

What Is FreeSWITCH™?

FreeSWITCH™ is an open source communications platform written in C from the ground up. Licensed under the MPL 1.1 and running natively on Windows, Mac OS X, Linux, *BSD, and other Unix flavors, potential users are given many choices on how and where to run the software.

With a desire to not reinvent the wheel, we've designed FreeSWITCH to take advantage of as many existing software libraries as possible. It has a modular, extensible architecture, with only limited and necessary functionality in its core. Optional modules can be employed to add virtually any functionality desired by the user.

  • Default implementation is for a PBX or Softswitch.
    • The core (libfreeswitch) can be embedded into almost any app that can use a .so or .dll.
    • Transform it into a softphone, PBX, soft-switch or anything in between.
  • Module system allows you to extend FreeSWITCH easily.
  • Handles thousands of concurrent channels with media on a standard PC.
  • Interoperates with many different products and protocols.
    • Such as GNU Bayonne, Yate, sipXecs or Asterisk.
    • Supports SIP, SCCP, H.323, LDAP, Zeroconf, XMPP / Jingle, etc.
    • With FreeTDM, a BSD licensed TDM abstraction library, it can interface with the PSTN as well.
  • Supports Secure RTP (SRTP) and zRTP (libzrtp).
  • Please see the complete Feature list for more features.


Top Links: Spec Sheet | Documentation Guidelines | Installation Guide | Getting Started Guide | Reporting Bugs | Documentation Feedback


News

Newspaper.jpg Learn about the different aspects of FreeSWITCH™, from What's New to the Current Status, FreeSWITCH™ Project News and even when FreeSWITCH™ is in the news.

Community and Support

Chat icon.gif
  • Help us edit our Wiki! Wiki editing / wiki feedback: Wiki Guide.
  • Freeswitch-ES First FreeSWITCH Spanish Community
  • freeswitch-users user mailing list (Learn how to ask smart questions before posting!)
  • freeswitch-dev developer mailing list
  • IRC Chat - irc.freenode.org, channels: #freeswitch, #freeswitch-dev, #freeswitch-social, #freeswitch-docs, #freeswitch-web, #freeswitch-de, #freeswitch-es, #freeswitch-fr, #freeswitch-pl, #freetdm
  • freeswitch-ru FreeSWITCH Russian Google group & Jabber conference freeswitch@conference.jabber.ru (обсуждение на русском)
  • freeswitch.ru FreeSWITCH Russian wiki and forum
  • freeswitch.de German FreeSWITCH site
  • FreeSWITCH-CN Non-official FreeSWITCH Chinese community
  • FreeSWITH-VoIP88 FreeSWITCH Chinese wiki and forum
  • IRC en français - irc.geeknode.net channel #freeswitch or irc.freenode.net channel #freeswitch-fr
  • Voice Conference
    • SIP: 888@conference.freeswitch.org
    • H.323: 888@conference.freeswitch.org
    • IAX: guest@conference.freeswitch.org/888
    • Google Talk/Jingle: 888@conference.freeswitch.org
    • PSTN: +1-989-386-9900 or +44-3300-100-295

Bounties

Currency.png
  • Need a feature or functionality that's not listed? Then put your money where your mouth is and help finance the project! Click here for to view or post your bounty.
  • Are you a programmer who wants to build something, but are looking for someone to sponsor the idea? Please add it to the bounty challenged ideas list.

Index

Home

[HOME]