Linphone

From VoIP.ms Wiki

[draft revision]

[quality revision]

Revision as of 17:45, 1 June 2020 (view source) Joseanmont (Talk | contribs) (→Configuring Linphone with Encryption) ← Older edit		Latest revision as of 18:44, 15 April 2024 (view source) RP (Talk | contribs)
(9 intermediate revisions not shown)
Line 1:		Line 1:
		+	Linphone is an internet phone or Voice Over IP phone (VoIP). With linphone you can communicate freely with people over the internet, with voice, video, and text instant messaging.
		+
		+
		+
	==Configuration Detail==		==Configuration Detail==
-	* Start Linphone Softphone	+	* Download Linphone [https://www.linphone.org/ Here].
-	[[File:Linphone_1.png]]	+	* Once downloaded, install it and then start Linphone Softphone.
-	* Click on the '''Assitant''' option.
-	[[File:Linphone_2.png]]
-	* Select the option '''Use a SIP Account'''.	+	* You will be greeted with the following screen. Press '''Assistant'''.
-	[[File:Linphone_3.1.png]]	+	: [[File:LinphoneNew1.png|500px|border]]
-	* Fill in the information according to your account
-	** '''Username:''' 100000 (Your Main SIP User ID or Sub Account ID).
-	** '''Display Name:''' Your name or company name.
-	** '''SIP Domain:''' atlanta.voip.ms
-	** '''Password:''' Your Main SIP password or Sub Account password.
-	** '''Transport:''' UDP or TCP.
-	Note: atlanta.voip.ms can be replaced with any of the servers available with voip.ms.
-	* Click on the '''Use''' button	+	* Next, press '''Use a SIP Account'''.
		+	: [[File:LinphoneNew2.png|500px|border]]
-	* Your Linphone should be ready to make calls	+
		+	* Next, press '''I Understand'''.
		+	: [[File:LinphoneNew3.png|500px|border]]
		+
		+
		+
		+	* Fill in the information according to your account:
		+	** '''Username:''' Your Main account or sub account username (six digit number) E.G 123456 / 123456_XX (the underscore has to be used for sub-accounts)
		+	** '''Display Name:''' Your name or company name. <font style="color:#FF0000;">'''(See the requirements below)'''</font>
		+	<div style="margin-left:50px;
		+	padding:8px;
		+	border-left: 6px solid rgb(73, 111, 199, 0.8);
		+	box-shadow: 5px 4px 4px 4px #f5f5f5;
		+	background-color: rgba(73, 111, 199, 0.08);
		+	width:68%;">
		+
		+	'''IMPORTANT - Display Name'''<br/>
		+	* Entering outbound Caller ID Name, it must be in '''CAPITAL LETTERS'''. ''This will appears more clearly/visible on some devices.'' <br/>
		+	* You must '''NOT use any special characters'''. ''They will not be displayed and it prevents potential outbound call issues.'' <br/>
		+	* Do '''NOT exceed 15 characters'''. ''Traditional canadian providers will '''not show more than 15 characters'''. We suggest shrinking or adapt the name.''<br/>
		+	* Spaces are allowed in a caller ID name '''but count as a characters.''' ''(do not exceed 15 chars. in total)''.
		+	</div>
		+	** '''SIP Domain:''' One of VoIP.ms multiple [[Choosing Server#Choosing_a_Server | servers]], choose the server closest to your location.
		+	** '''Password:''' The password you set for the account / sub account.
		+	** '''Transport:''' Select UDP or TCP.
		+
		+
		+	* Once everything is filed, click on the '''Use''' button.
		+
		+	: [[File:LinphoneNew4.png|500px|border]]
		+
		+
		+	* Your Linphone is now ready to make calls!
	* To confirm that you have registered this softphone properly, you can make a call to the Echo test application (dial 4443).		* To confirm that you have registered this softphone properly, you can make a call to the Echo test application (dial 4443).
		+
		+	: [[File:LinphoneNew6.png|500px|border]]
		+
	== Configuring Linphone with Encryption ==		== Configuring Linphone with Encryption ==
-	[[File:Linphone_3.1.2.png]]	+	If you decided to use '''SIP TLS - call encryption''' along with '''Linphone''' please follow these steps:
		+
		+	'''1.''' Make sure your Main account or sub-account has '''"Encrypted SIP Traffic"''' enabled.
		+
		+	Bear in mind, if this setting is enabled and your device sends '''UDP/TCP''' or '''RTP''' you will be rejected
		+	with error code 488.
		+
		+	Enable this setting for the Main Account at '''Main Menu>> Account settings>> Advanced tab'''.
		+
		+	[[File:Mainacc encryp.png|thumb|none|600px|Click to enlarge]]
		+
		+
		+	For a sub-account enable it at '''Sub accounts>> Manage sub-accounts''' by clicking on the orange icon with a pen and finally click at '''"Advanced Options (Click here to display)"'''.
		+
		+	[[File:Subacc encryp.png|thumb|none|600px|Click to enlarge]]
		+
		+
		+	'''2.''' Now that your account/sub-account has this setting enabled, your Linphone needs to send '''TLS''' and '''SRTP'''.
		+
		+	: [[File:LinphoneTLS1New.png|500px|border]]
		+
		+
		+	* Edit your current account.
		+
		+	: [[File:LinphoneTLS3.png|500px|border]]
		+
		+
	* Fill in the information according to your account.		* Fill in the information according to your account.
Line 34:		Line 91:
	* On the option '''Transport''' select TLS.		* On the option '''Transport''' select TLS.
-	[[File:Linphone_6.png]]	+	: [[File:LinphoneTLS4.png|500px|border]]
-	* Click on the menu that is on the top right corner and click on Preferences.
-	* Click on the tab '''Call and Chat''' and enable "SRTP".
-	[[category:softphones]]
-	==Ring time option on the Linphone softphone==	+	* Press '''OK''' and then proceed on the tab '''Calls and Chat'''.
-	The Linphone softphone has it's own ring time option and in some cases it's possible that you have to edit the value on that option if you experience issues reaching your voicemail on the ring time range that you have set in the DID settings on the voip.ms customer portal.	+	* For the option '''Encryption''', change it from '''NONE''' to '''SRTP''' and press '''OK'''.
-	In order to do this, please note that the versions for Ubuntu, Windows and possibly other platforms don't have an option to change this setting at the GUI config interface and to increase or decrease the number of seconds that Linphone will ring before going to voicemail (if you want to use the voicemail option at your voip.ms customer portal) you will have to edit the ~/.'''linphonerc''' configuration file.	+	: [[File:LinphoneTLS2.png|500px|border]]
-	In order to configure this file, please note that you must stop and close the Linphone softphone, otherwise during shutdown, Linphone will overwrite the changes made to the file.
-	Once you access to ~/.'''linphonerc''' look for the '''inc_timeout=''' setting and adjust it to the number of seconds you want.	+	[[category:softphones]]
-		+
-	Please note that even if you configure the ring time in seconds within your voip.ms interface (on the DID settings page) the option on the Linphone will override this setting if inc_timeout=nn is less than the voip.ms DID settings.	+
-		+
-	You can also use the Show debug window under the Help menu on the Linphone to see some details of what is happening in the background while you run your softphone.	+

---

Latest revision as of 18:44, 15 April 2024

Linphone is an internet phone or Voice Over IP phone (VoIP). With linphone you can communicate freely with people over the internet, with voice, video, and text instant messaging.

Configuration Detail

• Download Linphone Here.

• Once downloaded, install it and then start Linphone Softphone.

• You will be greeted with the following screen. Press Assistant.

• Next, press Use a SIP Account.

• Next, press I Understand.

• Fill in the information according to your account:
  • Username: Your Main account or sub account username (six digit number) E.G 123456 / 123456_XX (the underscore has to be used for sub-accounts)
  • Display Name: Your name or company name. (See the requirements below)

• • SIP Domain: One of VoIP.ms multiple servers, choose the server closest to your location.
  • Password: The password you set for the account / sub account.
  • Transport: Select UDP or TCP.

• Once everything is filed, click on the Use button.

• Your Linphone is now ready to make calls!

• To confirm that you have registered this softphone properly, you can make a call to the Echo test application (dial 4443).

Configuring Linphone with Encryption

If you decided to use SIP TLS - call encryption along with Linphone please follow these steps:

1. Make sure your Main account or sub-account has "Encrypted SIP Traffic" enabled.

Bear in mind, if this setting is enabled and your device sends UDP/TCP or RTP you will be rejected 
with error code 488.

Enable this setting for the Main Account at Main Menu>> Account settings>> Advanced tab.

For a sub-account enable it at Sub accounts>> Manage sub-accounts by clicking on the orange icon with a pen and finally click at "Advanced Options (Click here to display)".

2. Now that your account/sub-account has this setting enabled, your Linphone needs to send TLS and SRTP.

• Edit your current account.

• Fill in the information according to your account.
• Append the port 5061 to the server. (E.g. atlanta1.voip.ms:5061)
• On the option Transport select TLS.

• Press OK and then proceed on the tab Calls and Chat.

• For the option Encryption, change it from NONE to SRTP and press OK.