The first step in the deployment process is to download and configure a Bullhorn Career Portal release package, as described below. The steps provided are for linux platforms, but can be replicated on a Windows server:
Prerequisites, ensure you have Node.js and PM2 installed.
1. Download the latest release of Bullhorn Career Portal
The latest stable version of Bullhorn Career Portal can be found Here.
Release Page will display. Right click and copy the url for the
career-portal-v[x.y.z]-dynamic.zip link and download it to your machine with wget
2. Extract Bullhorn Career Portal files from the Zip Archive
Now, unzip your file to the directory of your choice, this will the be the directory that you are running the application from.
3. Configure settings in the application configuration file
Navigate to the extracted folder and open the
app.json file up in a text editor such as vim.
Locate and update the following values:
[ COMPANY NAME HERE ]- A string representing the name of your company, or another identifier which will appear in the masthead of list and card view.*
[ CORP TOKEN HERE ]- A string which identifies your company when accessing the Bullhorn REST API. This information can be provided by a Bullhorn Customer Specialist.*
[ SWIMLANE HERE ]- A quoted number which identifies the production environment for your company’s ATS/CRM instance. This information can be provided by a Bullhorn Customer Specialist.*
*This information must be obtained from Bullhorn Customer Support by creating a support ticket using the Bullhorn Resource Center. To create a support ticket, log into Bullhorn and navigate to Menu –> Support –> Bullhorn Resource Center.
Your Bullhorn Career Portal automatically identifies the locale for the user and translates the content on the career portal to match. If the user has multiple locales set in their browser, the locale chosen will be the first available option under
supportedLocales. If none of the user’s locales match, it will fall back to the option under
defaultLocale. The following locales are available by default:
- en-US - English (United States)
- en-GB - English (United Kingdom)
- fr-FR - French (France)
If you require support for a locale not listed here, please submit a GitHub issue.
Voluntary EEOC/OFCCP data collection
With the v2.0.0 release, you can elect to solicit self-identification data from your candidates by setting various EEOC parameters (“genderRaceEthnicity,” “veteran,” “disability”) to TRUE in the app.json file. If displayed, these fields will be required, but the respondent can select “I choose not to self identify.”
Check your app.json file
Once configured, your app.json file will look similar to the following. Please note that the brackets in the default file should be removed where you have added values for
clientId. For additional information about the configuration of the app.json file please see our wiki article on the configuration options available..
Save the file.
4. Start the Server
First, set the port that you would like the app to run
Using PM2, navigate to the
server sub directory, then set the port that you would like the app to be accessible from with
export PORT=PORTNUMBER. Once that has been done run
pm2 start server.js
** Thats It!** You are able to access the app at
http://localhost:PORT. The default port if a port was not chosen is 4000.