OnBase has a number of different user interfaces available which are called Clients. There is variety in the functionality and some specific advantages to each one. The OnBase team will help each area select the appropriate interface for their users as part of the project discovery and requirements. One implementation area can use multiple different user interfaces.

Any use of OnBase requires that you have a user login set up inside of OnBase. Login accounts are created and administered by the User Manager in your area. User Managers can create new accounts, add accounts to existing user security groups in OnBase, and re-set OnBase passwords if needed.

What if I am off campus?

In order to login to OnBase the computer you are working from must be on the BU network. If you are off-campus and want to access OnBase, you can do so, however you will ALSO need to be logged in to the BU VPN before connecting to OnBase.

What browser should I use?

If you are using an OnBase Web Client you must have an OnBase compatible browser.  Not all web browsers are compatible with our current version of OnBase. Here is a list of browsers that do and do not work with the two OnBase web clients most commonly in use at BU. Please also read the “What Client should I use?” section below for more details on which client you are likely using, browsers compatible with other OnBase web clients, and Mac vs. Windows platform considerations.

Browser Name Platform Evergreen HTML Only
Web Client
Active X
Web Client
Apple Safari 6.2 Mac OS X No Yes No
Apple Safari 7.1 Mac OS X No Yes No
Apple Safari 8.0 Mac OS X No Yes No
Apple Safari 9.0 Mac OS X No Yes No
Firefox 45 ESR Mac OS X
No Yes No Recommended for Macs because
Version upgrades can be controlled
Firefox 45+ (non ESR) Mac OS X 
Yes Yes No
Google Chrome 10+ Windows Yes Yes No Limited Support only
Google Chrome 46 Windows Yes Yes No Limited Support only
Google Chrome 49+ Windows Yes Yes No Note: There are issues importing documents using Chrome 50+
Microsoft EdgeHTML 13+ Windows Yes Yes Unknown Limited Support only
Microsoft Internet Explorer 11 Windows No Yes Yes Recommended for Windows

Any browsers not listed as supported in the above table are UNSUPPORTED at this time. OnBase will automatically block logins attempted from unsupported browsers.

Check out the Boston University Browser Information and Trouble Shooting page if you need more information about how to determine what version of a browser you are using or how to downgrade to an earlier version.

If you are using another application, such as BUworks, which requires a browser version not compatible with OnBase, you will need to choose one browser to use with OnBase and another to use with the other application and maintain their versions appropriately.

LIMITED SUPPORT: Limited support is now available for the Web Client in some browsers which are not fully compatible with OnBase. Standard client functionality such as Retrieval, Custom Queries, New Form, and Document Import and dialogs such as Keywords, Re-index, History, and Properties will be accessible. Modules such as Workflow will be inaccessible to the user when using a browser with limited support. The Web Server will automatically block access to unsupported modules and features. DocPop and FolderPop are accessible under Limited Support and specifically unsupported features will be automatically removed.

EVERGREEN BROWSERS: Evergreen browser versions stated above are explicitly supported. This means that Hyland has certified that version of the evergreen browser as being supported. Subsequent versions of each evergreen browser will be implicitly supported but will not undergo extensive testing by Hyland. The solution to any issues encountered on an implicitly supported browser version is to downgrade to a version that is explicitly supported. We do not have any recourse to changing OnBase functionality and compatibility.

What Client should I use?

Which client you should be using depends on the OnBase application area that you work in. More information about each client appears in the Clients section below.

Enter a Help Desk ticket for your desktop support area to request an OnBase client installation.

NOTE: Access to OnBase from mobile devices (eg. IPads, Black Berries, Android Phones, etc.) is not currently available at BU. Modules which will allow access through these platforms are available at additional cost and would require a project investigation through IS&T.

What client does my department / area use?

Client Areas For Windows For MACS
HTML Only Web Client Financial Aid (OFA)
Graduate Engineering
Graduate Medical Sciences
HR Global (HRG)
MET Grad
Provost / eCAP Users
Student Employment (SEO)
See compatible browsers above. See compatible browsers above.
ActiveX Web Client Admissions / Enrollment
HR Personnel
MET Grad – Program Coordinators only
MET Undergrad Admissions
See compatible browsers above. Not for Mac
Use HTML Only web client instead
FolderPop ISSO FolderPop is an integration which allows you to click a link in another application and open a related folder of documents in OnBase. See compatible browsers above.
Unity Client Accounts Payable
MET Graduate
A Windows-like client installed on the desktop Not for MAC
Unity or Thick Client via RDP Connection Admissions / Enrollment
HR Benefits
MET Grad – Program Coordinators
not browser based; RDP configured on desktop MAC / Linux Users with RDP access
Outlook 2013

Outlook 2016

Accounts Payable
Graduate ENG
Graduate Medical Sciences
HR Global
HR Personnel
MET Graduate
Not browser based, per user installation. Does not work with Office 365 Outlook, only desktop installation.

Outlook 2013 – MS Office must be 32 bit version. Windows can be 64 bit

Outlook 2016 – MS Office can be 32 or 64 bit version. Windows can be 32 or 64-bit. Use the appropriate installation files.

Requires .NET pre-requisite installation. This is an Outlook add-in which must be enabled.

Not for MAC
Thick Client All areas Some scanning stations
Servers & Developers
Administrators in some areas
Not browser based; desktop install
Requires an update to the C++ redistributable as a pre-requisite.
Requires a fixed IP address and firewall security clearance.Thick clients on any computers other than developers, servers or scanning stations should be replaced by the Unity Client.
Not for MAC

The OnBase Clients

OnBase has a number of different client interfaces available.

For each of the interfaces listed below there are notes about the interface and some important functional items:

There is a grid that shows what each different client can do on the OnBase User Group web page.

If you need to have an OnBase client installed, please send a Service Now help desk request requesting the client and specifying which users would like to use it. They should already have OnBase accounts issued to them by their User Manager and should be accessing an existing / known OnBase application.

Web Clients

Log in to web clients using your BU login and Kerboros password. You must still have an OnBase account set up but access will be granted through a single sign-on process. Web client access may also require that you have a DUO if your OnBase application contains sensitive information on documents or keywords. It is likely that adjustments will also have to be made to the Internet Explorer security settings on your desktop in order to use one of the web clients smoothly.

  • HTML-Only Web Client – does not require an active X installation on the desktop for use.
  • ActiveX Web Client – a local installation of ActiveX controls on your desktop computer is a pre-requisite to using this interface. This is a full featured web client.
  • Java Client- this client is no longer available with OnBase version 13 and later.

Unity Client

This is a full featured client that uses a familiar windows ribbon menu interface. It can be installed on Windows desktops. It is not available for MACs except via connection to a remote server (see below). Log in to the Unity client using your BU login and OnBase password.  The Unity Client can be used for all OnBase functionality including scanning, document separation, indexing, importing and more.

Unity Clients are installed on all scanning stations as of our conversion to OnBase 16 (July 2016) and ideally should be used for scanning and indexing going forward.  The Thick Client will be deprecated by the vendor in a future version release yet tbd.

The Unity Client does not currently have two-factor authentication in front of it and so may not be suitable for use in areas that have sensitive data in the keywords or documents. Requests for installation of the Unity Client will be reviewed with security in mind.

Outlook Client

This interfaces offers the opportunity to quickly and easily commit emails and email attachments as documents to OnBase. You can also quickly send a document out of OnBase attached to an email if appropriate security rights have been granted. A desktop installation is required to use this interface. This interface is only certified to work with Windows platform Outlook installation.

The OnBase Outlook add-on must be enabled and should be set to always start. It may take some time to start up and Outlook will sometimes automatically disable it.  You can manually re-enable it under add-ons.

Logging in to the Outlook Client is prompted the first time OnBase functionality is called for from the Outlook ribbon. Users login with their OnBase login and password. You will stay logged in as long as you do not close Outlook or until an hour has gone by with no OnBase activity. Your OnBase user license will be consumed as long as you remain logged into Outlook or until an hour has gone by without activity, so concurrent licenses may be tied up.

RDP Connection

RDP is an alternate way to use either the Unity or Thick Client by accessing a remote server rather than having a client installed on your desktop. This is a alternative suitable for Linux and Mac users. Access via RDP must be set up on your desktop. (RDP access replaces the former Quest Application Portal.)

In order to access OnBase via RDP you must have an OnBase account and also be in the appropriate security group. A remote connection must also be configured on your desktop.

  1. Request an OnBase account from your area’s OnBase User Manager if you do not already have a login.
  2. Request access to OnBase via RDP in a help desk ticket to Information Security. They need to add you to the group IST-OnBase-TS-Clients-AD.
  3. Request configuration of RDP access to OnBase on your desktop computer via a help desk ticket to Desktop Support.
    1. Specify if you want the Unity or Thick client. We strongly recommend using the remote connection to the Unity Client rather than the Thick Client as the Thick Client will be phased out in a near future version of OnBase. You do not need both.
    2. There is a ServiceNow Knowledge article documenting the settings. The article is available to Desktop Support and the help desk.

The Unity client is available via an RDP.  This is a good way for folks on Mac computers to utilize the Unity Client.

  1. You cannot scan into OnBase when accessing it via RDP.
    Do not install or use RDP on a scanning station computer!  Scan stations should always use the Unity client directly installed on the computer attached to the scanner.
  2. You can import a document from your desktop or a network share via an OnBase client using the default profile settings which are set to allow access to all disk drives.

All other functions available via the Unity Client above are available when you log in via RDP.

You must have installed the RDP client on your computer and you also must be in the appropriate security group to give you access to OnBase via RDP.

Current Version of OnBase

Boston University upgraded from OnBase 15 to OnBase 16 as of August 1, 2016.  In many areas KACE was used to push upgrades to the Thick Client, Active X, Unity and Outlook clients out. HTML Only client users do not need to make any changes. ActiveX Web client users need the new ActiveX controls but the link to the client has not changed. If you need assistance with your clients please log a help desk ticket to Desktop Support.

OnBase Test Environment

In addition to multiple user interfaces, there are two different OnBase environments that you might interact with. If you are asked to conduct testing on new development or changes to OnBase configurations, you might need a login to our Test environment. User Acceptance Testing should always be done in the same OnBase client that will be used in Production.

OnBase user accounts are set up separately in Production and Test so you can not assume that if you have a login to one that you will have both. The User Manager for your area should be able to set up accounts in either environment.

Web Clients for Test

All the web clients listed above for the Production environment are also available in the Test environment. However they have different and separate web links (favorites). The appropriate link to the Test client will be provided to testers as needed. If you favorite or bookmark the Test environment be careful to label it clearly and select the correct URL (favorite/bookmark) for the environment you want to log into.

Unity Client for Test

The same Unity Client installation on a desktop can be configured to allow access to both Production and Test environments. This requires desktop support to edit a configuration file. When booting up the Unity Client to access the TEST environment, make sure to select the appropriate environment before logging in.

Thick Client for Test

The Thick Client requires a separate installation to access each environment. There will be a separate desktop icon for a Thick Client that points to TEST. When booting up the thick client to access the TEST environment, make sure to use the desktop icon that specifies ‘TEST’ and that “observrt” is displayed in the first drop down on the login screen. Use your OnBase login and password (not Kerboros).  If you use the production Thick Client desktop icon and select the test environment “observrt” it will not work. You will get an error.