[{"_1":2,"_177":-5,"_178":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_156":157},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_85":86,"_109":110,"_147":-5,"_148":11,"_149":17,"_150":11,"_151":-5,"_152":11,"_153":-5,"_154":155},"canonicalUrl","https://hub.docker.com/r/bludesign/faxserver/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","bludesign","reponame","faxserver","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":65,"_66":67,"_68":11,"_69":29,"_70":71,"_76":17,"_77":78,"_82":29,"_83":84},"categories",[],"content_types",[40],"image","date_registered","2018-06-16T14:03:12.755194Z","description","Send and Receive Faxes Using The Twilio Programmable Fax API","is_private","last_updated","2019-01-03T02:45:16.626625Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",180888,"repository_type","star_count",2,"status",1,"status_description","active","source","collaborator_count",0,"full_description","![Fax Server](https://media.bludesign.biz/fax_server_logo.png)\n\n

\n\t\n $\"API$ \n \n \n $\"Vapor\"$ \n \n \n $\"MIT$ \n \n \n $\"Swift$ \n \n

\n
\n\n

\n\t\n

\n\nFax Server is a server for sending and receiving faxes with the [Twilio Programmable Fax API](https://www.twilio.com/fax). It can also send and receive SMS/MMS messages with the [Twilio SMS API](https://www.twilio.com/sms/api) as well as receive messages with the [Nexmo SMS API](https://www.nexmo.com/products/sms).\n\n### 🏭 Installing\n\n#### Using Docker\n\nThe easiest way to install is with [Docker](https://www.docker.com)\n\n git clone --depth=1 git@github.com:bludesign/FaxServer.git\n cd FaxServer\n docker-compose up\n\nAfter starting the server will be running at [http://127.0.0.1:8080](http://127.0.0.1:8080)\n\nTo run the server in the background run `docker-compose up -d`\n\n#### Manually\n\nIf it is not already installed install [MongoDB](https://docs.mongodb.com/manual/installation/) if you are using authentication or a non-standard port set it with the `MONGO_HOST`, `MONGO_PORT`, `MONGO_USERNAME`, `MONGO_PASSWORD` environment variables.\n\nNext install Vapor and Swift here for [macOS](https://docs.vapor.codes/2.0/getting-started/install-on-macos/) or [Ubuntu](https://docs.vapor.codes/2.0/getting-started/install-on-ubuntu/).\n\nThen build and run the project:\n\n git clone --depth=1 git@github.com:bludesign/FaxServer.git\n cd FaxServer\n vapor build --release\n .build/release/App\n\nThe server will now be running at [http://127.0.0.1:8080](http://127.0.0.1:8080). Note running the server with `vapor run serve` will not work it must be run directly with the `App` in `.build/release` directory.\n\n### 🚀 Deploy\n\nThe server must be reachable from the internet which can be done using [Nginx](https://docs.vapor.codes/2.0/deploy/nginx/#configure-proxy) (Recommended) or [Apache2](https://docs.vapor.codes/2.0/deploy/apache2/).\n\nIf using Nginx the `client_max_body_size` must be increased to allow for larger PDF file uploads.\n\nExample Nginx Config:\n\n server {\n listen 80;\n \tclient_max_body_size 20M;\n\n location / {\n proxy_set_header Host $http_host;\n proxy_pass http://127.0.0.1:8080;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_pass_header Server;\n proxy_connect_timeout 3s;\n proxy_read_timeout 10s;\n }\n }\n\n### 🔧 Configuration\n\nFirst visit the Fax Server's address and register a new user account after you create your account you should disable user registration in settings.\n\n#### Twilio Configuration\n\n![Fax Server](https://media.bludesign.biz/fax_twilio.png)\n\n- Open the [Manage Active Numbers](https://www.twilio.com/console/phone-numbers/incoming) page on Twilio.\n- For each number you will be using configure Twilio to forward faxes and if you want SMS then messages to your server.\n- Use `https://(Server Address Here)/fax/twiml` and `https://(Server Address Here)/message/twiml` for the webhooks.\n- Visit the [Twilio Account](https://www.twilio.com/console/account/settings) page to get your Account SID and Auth Token.\n\n#### Nexmo Configuration (Optional)\n\n> SMS messages can only be received from Nexmo so no accounts need to be added in Fax Server to receive messages.\n\n- In your Nexmo account settings under API settings make sure the HTTP method is set to POST.\n- Under Numbers in Nexmo set the SMS webhook URL to `https://(Server Address Here)/message/nexmo`\n- Nexmo must be enabled in Fax Server settings if it has been disabled.\n\n#### Fax Server Configuration\n\n- Login to Fax Server and click on Accounts.\n- Create an account for each phone number you will be using for faxing or SMS messaging using the Twilio phone number, account SID and Auth Token from above.\n- If you have multiple phone numbers for the same Twilio account create separate accounts in Fax Server for each phone number using the same Account SID and Auth Token for each.\n- For email notifications setup an account with [Mailgun](https://signup.mailgun.com/new/signup) and set the email addresses, Mailgun API Key and Mailgun API URL in Fax Server Settings.\n\n> It is possible to add phone numbers to Fax Server that are not in your Twilio account but have been [verified](https://support.twilio.com/hc/en-us/articles/223180048-Adding-a-verified-outbound-caller-ID-with-Twilio) this can be used to add a number such as a regular fax machine allowing you to send faxes from Fax Server and still receive them on a regular fax machine. Note this does not apply to SMS messages, SMS messages can only be sent from Twilio numbers they can not be sent from Twilio verified numbers.\n\n### 🔒 **Important** - Securing Fax Server\n\n- **[Must Be Done]** Disable user registration in Fax Server settings after setting up your user account so that new users can not be created. Note you can always create new users in the Users section this only disables anonymous user creation.\n- **[Strongly Recommended]** Setup HTTPS on the proxy server (Nginx or Apache2) see tutorial [here](https://www.digitalocean.com/community/tutorials/how-to-secure-nginx-with-let-s-encrypt-on-ubuntu-16-04).\n- [Advanced Users] Enabled secure (HTTPS Only) cookies in settings. This should only be done if you only access your server over a HTTPS connection and will restrict logins to HTTPS only. Note if you enable this you will not be able to sign in over an insecure (HTTP) connection to turn if off.\n- [Advanced Users] Enable 2 factor authentication (TOTP) login, under Users select your user account and activate 2 factor authentication. Note there is no way to reset this if you loose your TOTP secret key.\n- [Advanced Users] If you will not be receiving Nexmo SMS messages the webhook can be disabled in Fax Server settings.\n\n### 📱 iOS App Setup\n\n![Fax Server](https://media.bludesign.biz/fax_client.png)\n\n- Open Clients in Fax Server and create a client with the above values.\n- After creating the client copy the Client ID and Client Secret and fill them into the iOS app along with your servers URL.\n\n

\n\t\n\t\t $\"App$ \n\t\n

\n","has_starred","hub_user","immutable_tags_settings",{"_72":11,"_73":74},"enabled","rules",[75],".*","is_automated","permissions",{"_79":17,"_80":11,"_81":11},"read","write","admin","user","storage_size",5107582589,"orgData",{"_87":88,"_89":90,"_91":92,"_93":29,"_94":95,"_96":97,"_98":95,"_99":100,"_101":102,"_103":104,"_105":106,"_107":106,"_108":17},"id","c4107b881e64489897135533cf7241e4","uuid","c4107b88-1e64-4898-9713-5533cf7241e4","type","organization","orgname","full_name","BluDesign","location","Vineyard Haven, MA","company","profile_url","https://bludesign.biz","date_joined","2017-09-30T05:19:38.419667Z","gravatar_url","https://www.gravatar.com/avatar/81b82420824b8e3138913665b65289ad?s=80&r=g&d=mm","gravatar_email","","badge","is_active","recentTags",[111],{"_112":40,"_113":114,"_115":116,"_87":117,"_118":119,"_46":136,"_137":114,"_138":29,"_139":52,"_53":140,"_141":142,"_143":127,"_144":136,"_145":62,"_146":17},"content_type","creator",2207143,"full_size",687452022,29323848,"images",[120],{"_121":122,"_123":124,"_125":106,"_126":127,"_128":129,"_130":131,"_132":106,"_133":-5,"_134":116,"_59":62,"_135":-5},"architecture","amd64","digest","sha256:3112ce54a6756fd060be9daddebf916a4dfd0b2962afae7536714813130d23eb","features","last_pulled","2026-09-26T18:03:06.26440323Z","last_pushed","2019-01-03T02:45:17Z","os","linux","os_features","os_version","size","variant","2019-01-03T02:45:16.26495Z","last_updater","last_updater_username","media_type","latest","repository",5627907,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":158,"_165":166,"_154":175,"_176":11},{"_36":159,"_38":160,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":161,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":65,"_66":67,"_68":11,"_69":29,"_70":162,"_76":17,"_77":164,"_82":29,"_83":84},[],[40],[52],{"_72":11,"_73":163},[75],{"_79":17,"_80":11,"_81":11},"tags",{"_167":60,"_168":-5,"_169":-5,"_170":171},"count","next","previous","results",[172],{"_112":40,"_113":114,"_115":116,"_87":117,"_118":173,"_46":136,"_137":114,"_138":29,"_139":52,"_53":140,"_141":142,"_143":127,"_144":136,"_145":62,"_146":17},[174],{"_121":122,"_123":124,"_125":106,"_126":127,"_128":129,"_130":131,"_132":106,"_133":-5,"_134":116,"_59":62,"_135":-5},[],"canDeleteTags","actionData","errors"]

bludesign/faxserver

Tags for bludesign/faxserver