Trouble Activating License

Urchin was canceled in 2012 and it’s become extremely difficult to activate new Urchin installations. Plus, the newest version of Urchin (v7.2) is unaware of newer browsers & OS platforms, and the geolocation db is woefully outdated.

If you are having licensing issues with an active Urchin installation, you should consider migrating to Angelfish Software


Here are some troubleshooting steps to follow:

No Internet Connection


If you need to activate an Urchin License, but your server does not have an internet connection, you will need to contact Google to have a license manually generated for you.

  1. Log into your MySQL or Postgres Urchin database.
  2. Execute the following command: update uglobals set ucgl_serial='<YOUR SERIAL>’;
  3. Execute the inspector from urchin/util and save its output to a file.

With Internet Connection


If your Urchin server is able to contact the Internet but you are having trouble activating an Urchin serial code, it’s likely that the serial code is locked. Serial codes are single use only.

  • The Urchin server crashed and Urchin is being reinstalled.
  • The Urchin server was deprecated and Urchin is being installed on a new server.

Post-2012, Google was the only company that could reset Urchin serial codes. As of 2019, it’s unclear if Google is still resetting Urchin serial codes.

If your Urchin installation no longer works, you best option might be to migrate to Angelfish Software.