<span style="display:block;height:15px!important"></span>
<p align="center"><img src="https://git.doublebastion.com/pax-fax/raw/develop/img/pax_fax_logo.png" alt="Pax Fax" width="146px" height="140px"/></p>

<span style="display:block;height:20px!important"></span>

**Pax Fax is a Nextcloud application that allows sending and receiving faxes in Nextcloud.**

A phaxio.com account and a real fax number acquired from Phaxio are needed.

<span style="display:block;height:20px!important"></span>

## Main Features
<span style="display:block;height:10px!important"></span>

* 🚀 Multiple documents can be sent in one fax call (up to 20 separate files).

* 📠 A fax can be sent to multiple fax numbers at once (up to 15 different fax numbers).

* 📄 Users can send as fax any document in any of the following formats: pdf, doc, docx, odt, jpg, png, tif, tiff, txt, html.

* 📰 All incoming faxes are received as pdf documents and stored in a Nextcloud folder.

* 📧 Users receive notifications and (optionally) emails when new faxes arrive.

* 🔍 All the sent and received faxes are stored in specific Nextcloud folders, so that they can be searched by caller/callee phone number or date.

* 💻 When they want to send a fax, users can upload files from their computer or choose them directly from Nextcloud.

* 🔏 Incoming fax requests are checked for authenticity and integrity by verifying Phaxio's signature.

* 💵 Current Phaxio balance can be always checked by pressing a button on the left panel.

* 💰 The only ongoing cost is $2 per month for a fax number located in USA or Canada, in a city chosen by the user. No contracts.

* 💸 Straightforward pricing: $0.07 per sent/received page for faxes to/from USA and Canada and $0.1 per sent/received page for faxes to/from other countries.

<span style="display:block;height:10px!important"></span>

In one fax call a user can send files with a cumulative size of up to 20 MB.

Double Bastion is not affiliated with Phaxio.

<span style="display:block;height:20px!important"></span>

Send uploaded file as fax
<span style="display:block;height:10px!important"></span>
![Image of Pax Fax Interface](https://git.doublebastion.com/pax-fax/raw/develop/img/pax_fax_send_uploaded_file_as_fax.png)
<span style="display:block;height:40px!important"></span>
Preview received fax
<span style="display:block;height:10px!important"></span>
![Image of Pax Fax Interface](https://git.doublebastion.com/pax-fax/raw/develop/img/pax_fax_received_fax.png)
<span style="display:block;height:40px!important"></span>
Choose file from Nextcloud
<span style="display:block;height:10px!important"></span>
![Image of Pax Fax Interface](https://git.doublebastion.com/pax-fax/raw/develop/img/pax_fax_choose_file_from_nextcloud.png)
<span style="display:block;height:40px!important"></span>
Choose multiple files from local computer and Nextcloud
<span style="display:block;height:10px!important"></span>
![Image of Pax Fax Interface](https://git.doublebastion.com/pax-fax/raw/develop/img/pax_fax_files_from_pc_and_nextcloud.png)
<span style="display:block;height:40px!important"></span>
View list of received faxes
<span style="display:block;height:10px!important"></span>
![Image of Pax Fax Interface](https://git.doublebastion.com/pax-fax/raw/develop/img/pax_fax_received_faxes.png)
<span style="display:block;height:40px!important"></span>
View list of sent faxes
<span style="display:block;height:10px!important"></span>
![Image of Pax Fax Interface](https://git.doublebastion.com/pax-fax/raw/develop/img/pax_fax_sent_faxes.png)
<span style="display:block;height:40px!important"></span>

## Browsers
<span style="display:block;height:10px!important"></span>

Pax Fax works with all the major browsers.

<span style="display:block;height:20px!important"></span>

## Programming Languages
<span style="display:block;height:10px!important"></span>

Pax Fax only uses PHP, SQL, jQuery, CSS and HTML. This means it's robust, efficient, light-weight and easy to maintain and debug.

<span style="display:block;height:20px!important"></span>

## Minimum Requirements
<span style="display:block;height:10px!important"></span>

- **Nextcloud 22+** has to be installed and properly configured, preferably by following the Install Nextcloud chapter in our guide.

- **A phaxio.com account and a fax number** attached to it.

- The **libcurl** PHP library has to be installed on the server.

To enable email notifications for every received fax, the "sendmail" utility ("/usr/sbin/sendmail" on Debian Linux), has to be present on the server. "sendmail" is a binary which gets 
installed when Postfix is installed. Also, the web server user (www-data) has to be allowed to send emails from command line (by specifying "authorized_submit_users = www-data" in 
"/etc/postfix/main.cf" for Postfix on Debian).

<span style="display:block;height:20px!important"></span>

## Installation
<span style="display:block;height:10px!important"></span>

<a href="https://www.doublebastion.com/install-nextcloud/#install-pax-fax" rel="noreferrer noopener" target="_blank">This chapter</a> of our Complete Guide to a Complete Linux Server 
presents in detail how to install and use this application.

Pax Fax is a component of RED Scarf Suite. It can be installed and used alone, but if you want to install <a href="https://www.doublebastion.com/red-scarf-suite-components/" rel="noreferrer noopener" target="_blank">all 
the components</a> of RED Scarf Suite, you can follow our <a href="https://www.doublebastion.com/free-server/complete-guide-to-a-complete-linux-server/" rel="noreferrer noopener" target="_blank">complete guide</a>.

<span style="display:block;height:20px!important"></span>

## Contribute
<span style="display:block;height:10px!important"></span>

This is the official git repository of Pax Fax. The <a href="https://github.com/DoubleBastionAdmin/pax-fax" rel="noreferrer noopener" target="_blank">GitHub Pax Fax
repository</a> is just a pointer to this repository. We don’t use GitHub for developing Pax Fax because GitHub is owned by one of the companies that proved their disrespect for
digital freedom over the years and because centralized services create autonomy and privacy issues, in spite of all the benefits.

If you want to contribute code to this project, please submit <a href="https://git.doublebastion.com/pax-fax/pullrequests/contrib" rel="noreferrer noopener" target="_blank">this form</a>, 
mentioning your intended changes. We'll send you the credentials needed to push code to the "contrib" branch of this repository. After we review the changes we can include them in the 
project.

Please post any bugs that are not security related, or feature requests, on the <a href="https://git.doublebastion.com/pax-fax/issues/develop" rel="noreferrer noopener" target="_blank">
issue tracker</a>. If you notice bugs related to security, don’t post them on the issue tracker; instead, send them to manager [at] doublebastion [dot] com .

<span style="display:block;height:20px!important"></span>

## License
<span style="display:block;height:10px!important"></span>

Pax Fax as a whole is licensed under the GNU Affero General Public License Version 3. If you use Pax Fax or distribute it in modified or unmodified form, you will need to comply with 
the terms of the GNU Affero General Public License Version 3.

Pax Fax includes libraries licensed under different free software licenses. These libraries contain their respective original copyright notices.
