Set up your job board up and running

Installation guide

Installation guide put into single sentence – “Upload files to a server, create a database and finish single click installation in the browser”

Project is lightweight, based on plain PHP & MySQL + frontend technologies HTML / CSS / Javascript. Therefore it is portable and you can easily set it up anywhere either on shared hosting or a private server. After step 2 your website will look just like the demo with sample jobs and content.

Users who do not wish to get involved with the technology can let us do the job and order installation service or alternatively get a SaaS hosted solution.


1. Project download

You can do so HERE. After unzipping you will see following folders:

  • etc – folder with web server (Apache, NGINX, IIS) configuration scripts (only needed for private virtual servers)
  • upload – project source files


2. Website setup

  • Copy content of the “upload” folder to your server. If using cPanel upload whole archive, extract it and move content of “upload” folder into your public_html folder
  • Try to avoid sub-folders, upload project to the public html directory
  • If you experience any issue with permissions see how to setup permissions. You need to right click the folder, and change the “numbers”. Try to open your website in browser, installer will test the permissions and tell you if you need to change them.
  • Create a database for your project and finish the single click installation in the browser. For the App Url, use your domain without http (eg. “” or “localhost”)


Installer screen

Installer screen


After the steps above if done correctly the job board is ready to be used. Below, we describe common scenarios that can occur. If SJS installation works find you can skip this subsection.

Potential issues and solutions:

A) SJS has been deployed on a Windows based hosting that is not supported. In this case please try to use a Linux based hosting provider.

B) SJS has been deployed into a subfolder – e.g. “”. If the design does not show up properly try to open browser developer tools and watch if there are any error messages in the console. If you see that web server is loading assets and styles from a wrong URL this is the case. We recommend installing SJS into its own public_html folder and running the job board on a subdomain – e.g. “”. This way you can add the job board and run it along your main website while both sites reside independently.

C) Database connection error. Please double-check MySQL connection details. Is the server host address correct? Does the database user have permissions to work with the database table?

D) Is the website working, but after clicking on any page you get a web server error? Most probably the main .htaccess file did not get uploaded or replaced properly. In this case, please try to reupload the file into the public_html folder of the SJS installation. You can quickly download it from here (upload and extract the archive into public_html folder. Note: the file is hidden – not empty).

E) Is the website and pages working but when opening the admin dashboard at “/sjs-admin” you experience an issue? There is another admin .htaccess file responsible for routing the admin section requests. Download the admin archive from here, upload it into the public_html folder and extract. Some shared hosting providers do not allow subfolder .htaccess routing files and they disable them by default. If the issue with “/sjs-admin” still happens create a support ticket, inform your host that the folder routing does not seem to work and ask for a solution.

3. Emails setup

To connect recruiters with candidates and notify both sides when a job application occurs emails need to be setup. This is also essential for job alerts and contact form submissions to work. Open Admin -> Settings -> Mailer and enter the “Admin Email” address. Into this mailbox you will receive messages submitted from the contact form. By default SJS mailer uses phpmail() function, which in most cases will not deliver the message. Better option is to setup a reliable email sending service via SMTP:

Use SMTP servers of ZOHO MailGmail, Elastic email or any other provider. Follow our MAILER SETUP GUIDE tutorial to see how to setup the mailer with Gmail.

After the steps above the candidates will be successfully connected with the companies. In case you scale your website and get more traffic, you should consider paid SMTP service as they offer bigger data transmission plans. There is a possibility to schedule a cron job and send out a newsletter periodically with the latest jobs or marketing messages. In the administration area you are able to export all the subscribers’ email addresses into a CSV file, which can be then imported into transactional email provider websites such as Sending, Mailchimp or Amazon SES. There you can send marketing emails easily without setting up any cron jobs. You can read more about this topic in the customization guide.


4. Blog setup

Do not need a blog? In Admin -> Pages you can remove it from the menu. The blog will work out of the box, just make sure the “blog/content” folder has 777 permissions. You can manage the categories, posts, themes and settings in the admin area ( Log in credentials are admin/admin. If you wish to use more complex blogging platform, we recommend installing WordPress and pointing a subdomain to the instance, or alternatively use our WP addon where we setup WordPress blog and forum to run along the job board.


Customization guide
To get a good start follow our job board customization guide.

Download Simplejobscript HERE