** PLEASE NOTE: Following the closure of the HP app catalogue, instructions in this article involving the HP servers are no longer relevant and have been crossed out. **
So, you’ve decided to get yourself a “new” webOS-powered smartphone (or dig one out of the closet)! Let me be the first to welcome you to the family. We have suffered some blows recently, with HP finally shutting down app catalog purchases as of November 1, 2014, and closing down the Palm Profile servers as of April 15, 2015. But all of the devices and other services will continue to work, and many developers are making their apps available through homebrew channels.
We believe this is still the most intuitive and easiest to use mobile platform, and we still have the greatest community dedicated to keeping it that way!
This guide is the first in a series of guides that will help you get started with your new webOS smartphone, as there have been a few changes to the ecosystem since the official manuals were written. This guide focuses on getting your webOS smartphone activated and ready to use. Later guides will cover optimizing your device, available apps, and some interesting things that you can do which were never covered by the official documentation.
This guide assumes that you have either:
- A phone that has been locked to the carrier of your choice and an appropriate SIM card; or
- An unlocked phone and SIM card that will work on the carrier of your choice.
Here’s what I’ll cover in the guide:
Create a new Palm Profile
- Get Connected (Optional)
Roll back the clock and update the app catalog
- Enable Developer Mode
- Download webOS Quick Install
- Install the Root Certificate Update
- Prepare for Patching
- Install the Google and Yahoo Sync Patches
- Enable Access for “Less Secure Apps” on Google (Optional)
- Install Preware
By the end of this guide, you’ll be ready to install applications, add accounts, and get to work.
Before We Begin:
If you’re not familiar with webOS and the way that gestures work, I recommend watching this video before starting this guide.
The video was originally released when the first Palm Pre came out, so the process has changed slightly, but all of the gestures and the way that you interact with the phone are still basically the same.
Step 1: Create a new Palm Profile
Insert your SIM card and power up your phone. As soon as the phone finishes booting,
it will run you through the process of creating a Palm Profile (or logging into an existing one) and doing the initial setup of your phone (this will no longer work, so the next two paragraphs are now REQUIRED. See also this information on bypassing activation).
If you have to manually configure your APN settings you’ll need to bypass activation by tapping the phone icon, tapping Emergency Call, backing out 911, and entering #*DEVMODE# and tapping the call button. Then toggle Developer Mode to on, confirm, and tap Submit. Restart your phone and then you’ll need Impostah.
For those with a CDMA webOS phone, you can tap the phone icon, back out 911, and dial your carrier’s activation number. Then simply backswipe or turn off your device and turn it back on to resume setup. You can also bypass activation with ##DEVMODE# (yes that’s a second # and not a *) but you don’t have to press call.
If you’d like a bit of practice with gestures, I’d also highly recommend running through the gesture tutorial when it’s offered.
Step 2: Get Connected (Optional)
From card view (even if you have no cards up right now), either tap on the launcher arrow or use the Up gesture to bring up the launcher, and swipe over to the “System” panel. Then, find the “Wi-Fi” app and tap on it to launch.
Make sure that Wi-Fi is turned on, and you will see a list of available networks in range. Tap on the one that you would like to connect to, and enter the network password (if necessary).
Once you’re connected, use the Up gesture to get back into card view and toss the Wi-Fi card away.
Step 3: Roll back the clock and update the app catalog On July 23, 2013, the webOS root certificate expired. This means that new webOS devices cannot access the App Catalog to download and update applications or access other services such as Backup, without first installing a new certificate. Please note that this procedure is only necessary until January April 15, 2015, at which point the services that this certificate is needed for will stop functioning. HP was kind enough to push out an update to the App Catalog that included a new certificate. Unfortunately, you can’t download and install it after July 1, 2013 because the certificate to allow you to do so has already expired. Fortunately, there’s a workaround for that! Open the “Date & Time” app on your device. This is typically on the “System” or “Settings” page/tab of your launcher. Set “Network time” to Off. Set the date to July 1, 2013. Open the App Catalog. This is typically on the first page of the launcher. Type “App Catalog Update” in the search field, and hit “Enter” on the keyboard. Tap “Download for Free” to download and install the app. Go back to the “Date & Time” app. Set the date back to the current date. Set “Network Time” to On.
Step 4: Enable Developer Mode
While HP stopped most support for webOS back in 2012, there is still a vibrant developer community that works tirelessly to keep our webOS devices working in the modern world. They can do that because Palm made a commitment to make webOS devices easy to tweak and modify, and load homebrew applications onto. HP kept up that commitment.
To fix a few services that have broken over the years and get your webOS device working to it’s full potential, we’re going to take advantage of some of that work, and to do so, we need to enable a feature called “Developer Mode”, which will allow us to apply this custom work to our devices.
Get your device into card view and type webos20090606 on the keyboard. You’ll see an application named “Developer Mode Enabler”. Tap on that, and when it launches, switch the toggle button for developer mode to On.
The screen may grey out for a second, but when it comes back, you should see the message: “Your device is in Developer Mode. You may use Palm Mojo SDK tools to connect to the device.” When see that, you’re good to go, and can toss the card away.
Step 5: Download WebOS Quick Install
NOTE: For this step, you’ll need a computer that is running Java 6 or later (available from java.com).
WebOS Quick Install, developed by Jason Robitaille is the premier tool for getting homebrew applications, tools and patches from a computer onto a webOS device.
Simply download it from here and save it to a location of your choice.
For more information on WebOS Quick Install, check out the official thread.
Step 6: Install the GlobalSign SSL Update.
Around January 28, 2014 a core GlobalSign SSL certificate expired, breaking Hotmail and Outlook.com accounts, and causing the webOS browser to stop trusting the certificates on many sites. Patch guru Matt Williams (Grabber5.0 on the webOS nation forums) quickly came up with a fix, putting together an updated certificate package to fix this problem, and making it available for download.
To install this update:
- Download the package and save to a location of your choice: Globalsign Root Certificate Updater
- Plug your device into your computer, and when asked if you want “USB mode” or “Just Charge”, pick “Just Charge”.
- Launch WebOS Quick Install by double-clicking on the file that you downloaded.
- Make sure that your device shows up in the upper right hand corner. (If this is your first time running the tool, you may be asked to install novacom drivers. These are what the tool uses to communicate with your phone. In that case, just follow the prompts).
- Click on the green plus icon on the right hand side of the window, navigate to the file that you downloaded, and hit select.
- Click the “Install” button, and wait for the tool to install the package. When it is done, the list of files to install will be empty, and you’ll be good to go.
If you need more detailed information, you can check out the original thread here.
Step 7: Prepare for Patching
In order to install “Patches”, bits of code that correct problems or change behaviors on your device, as wee will need to do in the next step, you will need to install a few programs to make that possible: AUSMT Scripts, GNU Patch, and Lsdiff.
If you haven’t already, Plug your device into your computer, and when asked if you want “USB mode” or “Just Charge”, pick “Just Charge” and launch WebOS Quick Install.
- Make sure that your device shows up in the upper right hand corner.
- Click on the “Globe” icon on the right-hand side (see thumbnail above). This gives you access to the Homebrew Catalog window.
- Along the top of the window, you will see several options (Applications, Services, Plugins, etc.). Click on “Linux Apps”.
- In the list on the left, find “AUSMT Scripts” and click on it. Then click the “Install” button at the bottom of the right hand panel.
- Once the install has completed, in the list on the left, find “GNU Patch” and click on it. Then click the “Install” button at the bottom of the right hand panel.
- Once the install has completed, in the list on the left, find “Lsdiff” and click on it. Then click the “Install” button at the bottom of the right hand panel.
- When all of these installs are complete, you can close the Homebrew Catalog window.
Step 8: Install the Google and Yahoo Sync Patches
In Late March – Early April of 2014, Google and Yahoo both began requiring secure connections when synchronizing data, and this broke the contact synchronization service in webOS. Fortunately, Matt Williams and frantid were on the case and came up with a solution to the Google problem. When the Yahoo problem started a week later, Matt was able to identify it as similar to the Google problem and fix it.
To install these patches:
- Download the Google patch from Matt’s site and save to a location of your choice: http://fordmaverick.com/GrabberSoftware/GoogleSyncFix/gsync-1.2.patch (Note: you may need to right click on the link and click save as, or your browser may try to open it).
- Download the Yahoo patch from Matt’s site and save to a location of your choice: http://fordmaverick.com/GrabberSoftware/YahooSyncFix/ysync.patch (Note: you may need to right click on the link and click save as, or your browser may try to open it).
- If you haven’t already, Plug your device into your computer, and when asked if you want “USB mode” or “Just Charge”, pick “Just Charge” and launch WebOS Quick Install.
- Make sure that your device shows up in the upper right hand corner.
- For each of the patches, click on the green plus icon on the right hand side of the window, navigate to the file that you downloaded, and hit select.
- Making sure that both files are in the “Files to Install” list, click the “Install” button.
- When finished, your device will restart, and you can quit webOS Quick Install.
Step 9: Enable Access for “Less Secure Apps” on Google (Optional)
If you plan to add Google accounts to your webOS device, you may need to enable this feature on each Google account that you plan to add, as webOS uses an older method of signing into Google that Google considers “less secure.”
- Go to https://www.google.com/settings/security/lesssecureapps
- Sign into your Google Account.
- Click “Enable”
- Click “Done”
Step 10: Install Preware
- If you haven’t already, plug your device into your computer, and when asked if you want “USB mode” or “Just Charge”, pick “Just Charge” and launch WebOS Quick Install.
- Make sure that your device shows up in the upper right hand corner.
- Click on the “Globe” icon on the right-hand side. This gives you access to the Homebrew Catalog window.
- Along the top of the window, you will see several options (Applications, Services, Plugins, etc.). Click on “Applications”.
- In the list on the left, find “Preware” and click on it. Then, click the “Install” button at the bottom of the right-hand panel.
- When the install is complete, you can close the Homebrew Catalog window and quit WebOS Quick Install
- On your phone, launch Preware. It will have been installed under the “Applications” panel of the launcher, right at the bottom.
- Read the introduction, then tap the “Ok, I’ve read this. Let’s continue…” button, and wait for Preware to update its feeds.
- When Preware asks you if you would like to associate the “.ipk” filetype, tap yes.
From here, we are no longer tethered to a computer and will be using Preware to do all of the application and patch installations. Also, now that the HP App Catalog is closed, Preware is the best way of getting new applications onto your device.
You now have a webOS device that is ready to use! You can install applications, add accounts, and start using it like it was meant to be used.
From here, I recommend that you:
- Take a look at the manual for your device to learn how to use some of the core applications. Or, if you’re more of a visual learner, you can watch some of webOS Nation’s (formerly PreCentral) walkthrough videos (email; Preferences; Contacts, Calendar, Tasks and Memos; and Messaging.) Again, these videos were originally released when the first Palm Pre came out, so things have changed somewhat, but are still very similar.
- Sign up for an account on the webOS Nation forums. It’s the largest gathering place for those running and working on webOS, and has a huge backlog of answers to problems, as well as many knowledgeable users who can help you if you run into a new one.
- Take a good look through the Preware catalog and the webOS Nation App Gallery (all of the apps there are available through Preware) to see what applications you might find useful. They’re all free, but don’t forget to donate to the developers for all of their hard work!
Even though your device is working now, you can make it work better. Take advantage of homebrew tweaks and optimizations in the next installment of this guide.