freeTether is an open source tethering application for webOS that turns your device into an access point/gateway that allows you to share your device's cellular data connection with other devices via WiFi, Bluetooth or USB.
The following information will help with installing freeTether on your device.
Preparing Your Device
The following steps should be taken to prepare your device for the installation of freeTether.
Remove Other Tethering Solutions
It is highly recommended to remove all previous versions of freeTether and freeTetherD, as well as, Mobile Hotspot. Other tethering solutions may conflict with freeTether as well.
The following method is the recommend way to install freeTether. By installing with Preware, you'll be certain to have access to the latest versions of freeTether.
- Open Preware
- Start typing “freetether” (no quotes), then press the enter/return key.
- Tap freeTether from the list
- Tap the Install button
- Open Preware
- Tap Available Packages
- Tap Application > System Utilities
- Tap freeTether from the list
- Tap the Install button
freeTether updates can be found and installed via Preware
Q: What version of webOS is freeTether available for?
A: freeTether is only available for webOS 1.4.5 and later.
Q: I think I've found a bug. What should I do?
A: freeTether is currently a beta/test release, so don't get all worked up if you encounter a bug. Please review the bug/features listed here before submitting your own. You should also consider removing all other tethering solutions and then try again; as one of the other tethering solutions may be causing the issue with freeTether.
Q: I don't see freeTether listed in Preware. What am I doing wrong?
A: Make sure you have both testing feeds configured. You need the "ALL" feed and your device specific feed. See the WebOS-Internals Testing Feed wiki page for more information.
Q: Where can I find the testing feeds?
A: The Webos-Internals Testing Feed information can be found here.
Here is a list of some systems and their current status/compatibility with freeTether.
Bluetooth USB WIFI (Open) WIFI (WPA) Linux Good Good Good Good MacOSX <=10.5 ? ? ? ? MacOSX 10.6 Good Broken Good Good Windows 7 (x86) ? Good Good Good Windows 7 (x64) Can work Good Good Good PS3 N/A N/A Good Good Wii N/A N/A Good Needs Work iPad N/A N/A Good Good
The following information will help to understand and use freeTether.
Each tethered interface has a section describing how to enable/disable the interface for tethering and how to configure any preferences for that interface, as well as, a section on configuring the TCP/IP options that the tethered interfaces will use.
The following steps will assist you in configuring and using freeTether for WIFI tethering.
Configure WIFI Preferences:
The WIFI Preferences can be accessed two ways.
- Tap the WIFI row listed in the Tethered Interfaces list.
- Tap or Swipe down the app menu and select WIFI Prefs.
This setting determines the name (SSID) of the WIFI hotspot network. Tap the Network row to change the SSID. (See Figure 1)
Security: [Open | WPA2 Personal]
This setting determines the type of security to be used for the WIFI hotspot network. Tap the Security row to change between the Open and WPA2 Personal. (See Figure 2)
[The following settings are only available if WPA2 Personal is selected for the type of security.]
This setting determines the passphrase used. Tap the Passphrase row to toggle between showing or hiding of the passphrase.
To configure your own passphrase, tap the Set Passphase button. A passphrase can be created two different ways. (See Figure 3)
- Tap the text field (above the Generate Random button) and enter your passphrase. (The passphrase needs to have a minimum of eight (8) characters.) Then tap the Set Passphrase button.
- Tap the Generate Random button to have freeTether generate a passphrase for you. Then tap the Set Passphrase button.
Enable/Disable Wifi Tethering:
Toggle the On/Off switch to enable or disable the freeTether WiFi tethering.
- Freetether wifiprefs1.png
- Freetether wifiprefs2.png
- Freetether wifiprefs3.png
The following steps will assist you in configuring and using freeTether for Bluetooth tethering.
Configure Bluetooth Preferences:
The Bluetooth Preferences can be accessed two ways.
- Tap the Bluetooth row listed in the Tethered Interfaces list.
- Tap or Swipe down the app menu and select Bluetooth Prefs.
PAN Profile: [Enabled | Disabled]
This setting attempts to enable Bluetooth PAN support for those carriers that may disable Bluetooth PAN support. (See Figure 1)
Enable/Disable Bluetooth Tethering:
Toggle the On/Off switch to enable or disable the freeTether Bluetooth tethering.
- Freetether btprefs.png
The following steps will assist you in using freeTether for USB tethering.
Note: Configuring computers to connect to freeTether using USB tethering is outside the scope of this wiki, however, there is a WebOS-Internals wiki page that contains a section (Computer Setup) with instructions on configuring your computer's operating system with specific drivers so that it will be able to work with freeTether's USB tethering, found here.
Enable/Disable USB Tethering:
Toggle the On/Off switch to enable or disable the freeTether USB tethering.
The following steps will assist you in configuring the TCP/IP Preferences for freeTether.
Configure TCP/IP Preferences:
The TCP/IP Preferences can be accessed two ways.
- Tap the DHCP Server section listed below the Tethered Interfaces list.
- Tap or Swipe down the app menu and select TCP/IP Prefs.
For a view of the TCP/IP Prefs... (See Figure 1)
This setting determines the gateway address that is used by the tethered clients as their connection point to your device.
This setting determines the subnet address that is used by the tethered clients.
This setting determines the starting address used when allocating IP address to the tethered clients.
This setting determines the maximum number of addresses available for allocation to the tethered clients.
This setting determines the length of time the tethered client's address allocation is valid. (Time is in seconds.)
- Freetether tcpipprefs.png
Official Bug/Feature Request Site
- 1.00.00 - Current Release - (Released Mar. 26th, 2011)
- Initial stable release
- Fixed TCP/IP settings not saving
- Fixed cookie bug not saving preferences
- Disable settings while interface active
- Add TCP/IP Preferences
- Default to Open for wifi tethering
- Styling tweaks
- Show passphrase hint
- Menu options for each interface
- Add client info scene
- End freeTether service on app close
- Default to WPA for wifi tethering
- Provide default passphrase
- Enforce min passphrase length
- Random passphrase generator
- Service fixes for race conditions and client list reporting
- Save and restore interface state
- Fix spinner states and multi-interface toggling
- Fix client list to correctly update hostnames
- Bluetooth PAN profile
- USB, Bluetooth and WiFi support
- webOS 1.4.5 and 2.x.x support
- Improved UI
Please see the issues list here for more information on the known issues.