Skip to content

ORServices is an open source, smartphone-friendly directory application that enables you to collect, verify, organize and share information about social services in your community with your stakeholders, beneficiaries, partner organizations and more.

Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

ORServices is a free, open source, smartphone-friendly directory application for health, human and social services that uses Open Referral data formats. It’s designed to be an easy to deploy, modify and maintain alternative to expensive proprietary nonprofit service directories often used by 2-1-1 systems in the USA.

You can use ORServices as an interface to manage all aspects of your service directory data, or you can manage your data using the OR Airtable Template and display it automatically via ORServices. We can also set up a custom publishing workflow for you whereby your data is transformed from its existing format into an Open Referral’s Human Service Data Standard (HSDS) zip file and regularly imported into an ORServices application.

Features include:

  • Web and mobile-friendly, geo-aware directory software
  • Human Service Data Standard (HSDS) compliant data model
  • Manage any facet of HSDS data within the app
  • Create and manage users, and assign them the ability to manage contact, service, location and organization information on an organization by organization basis
  • Content management system for customizing home and about pages, headers and footers, site colors, icons, images and logos.
  • Location-aware search and filtering
  • Manage multiple service taxonomies
  • Download PDFs and CSVs of individual and filtered lists of services and organizations.
  • Track and manage user data entry sessions
  • Import data from Airtable, HSDS CSVs, HSDS Zip and HSDS Zip API
  • Export data as HSDS CSV, HSDS Zip and HSDS Zip API
  • Integration with Google Translate to offer contents in dozens of different languages.
  • Integrate with Google Analytics for tracking user flows, usage statistics and more


👉Server Requirements:

The Laravel framework has a few system requirements. You will need to make sure your server meets the following requirements:

  • PHP >= 7.2.5
  • BCMath PHP Extension
  • Ctype PHP Extension
  • JSON PHP Extension
  • Fileinfo PHP extension
  • Mbstring PHP Extension
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension

👉 Web Server Configuration:


Pretty URLs Laravel includes a public/.htaccess file that is used to provide URLs without the index.php front controller in the path. Before serving Laravel with Apache, be sure to enable the mod_rewrite module so the .htaccess file will be honored by the server.

If the .htaccess file that ships with Laravel does not work with your Apache installation, try this alternative:

Options +FollowSymLinks -Indexes
RewriteEngine On

RewriteCond %{HTTP:Authorization} .
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]


If you are using Nginx, the following directive in your site configuration will direct all requests to the index.php front controller:

location / {
    try_files $uri $uri/ /index.php?$query_string;


  • Run git clone
  • Create a MySQL database for the project
  • mysql -u root -p, if using Vagrant: mysql -u homestead -psecret
  • From the projects root run cp .env.example .env
  • Configure your .env file
  • Run composer update from the projects root folder
  • Run npm install & npm run dev from the projects root folder
  • From the projects root folder run sudo chmod -R 755 ../orservices
  • From the projects root folder run php artisan key:generate
  • From the projects root folder run php artisan migrate
  • From the projects root folder run php artisan db:seed
  • From the projects root folder run composer dump-autoload

👉Database upload

  • Create database and upload sql dump file from database/dump/latest_date.sql

👉Local Development Server

  • If you have PHP installed locally and you would like to use PHP's built-in development server to serve your application, you may use the serve Artisan command. This command will start a development server at http://localhost:8000:
php artisan serve

Deploy to Microsoft Azure (App Service Deployment)

To deploy the application to Microsoft Azure ( follow the below steps. The guide assumes you have signed up for Azure account, have an active subscription and basic Linux server administration skills.

Create App Service

Create SQL Database

  1. Using Azure Database for MySQL servers (Recommended)
  • Navigate to Azure Database for MySQL servers ( and click "+ Add" button.
  • Choose between Single Server and Flexible server (Preview) - if you are testing OR services and/or on a limited budget, we recommened you select Flexible server. For production and high workload environment, go with Single server.
  • On Flexible server tab, click "Create"
  • Fill out subscription details, resource group, server name, region and workload type. On "Compute + Storage", you can leave it as default, or click "Configure server". Fill out the configuration for your optimal workload. Lastly fill out the username and password. Note these somewhere as you will use them to connect the application to the database.
  • Next, click the "Next: Networking". Here, make sure to check the box "Allow public access from any Azure service within Azure to this server" to allow App Service to connect to the database. If you need to connect to the database remotely from another computer, under "Firewall rules", add the computers IP address.
  • Lastly click "Review + Create". It will take sometime to provision the database server. Once the provisioning is done, note the database host (something like <YOUR_SERVER_NAME>
  • It's important to note, the provisioning does not automatically create a database. To create a database, connect to the server (you can do this from App Service console). To connect to the server from App Service, go to the console and
   mysql --host=<YOUR_SERVER_NAME> --user=<YOUR_USERNAME_NAME> -p

You will be prompted to type your password. Provide the password you used when creating the server. Once connected to server, create a database by using

   create database <DATABASE_NAME>;

Note somewhere the host (<YOUR_SERVER_NAME>, database name (created in the command above), username and password (both supplied when creating the server).

  1. Using Azure SQL Databases
  • Navigate to SQL Databases ( and click "+ Add" button.
  • Fill out the details and click "Review + create" button. Make sure to select the subscription you created ealier and the resource group. Provide the database name, for Server, click create new and fill out the pop out form with server name, server admin login (this will be the database username), password and location (Its advisable to pick the same location as your App service). Save these details somewhere since you will need them to connect the application to the database. For Want to use SQL elastic pool? - select No. For Compute + storage - leave as default or configure based on your needs.

Deploying the application

  • Navigate to the App Service we created in step one
  • On the left side menu, under "Deployment", click Deployment Center. For this deployment, we shall FTP manual code upload. If you have a paid plan, you can link your Github/Bitbucket account and create CI/CD pipeline to automatically deploy code from your repo to the app service. Obtain FTP credentials and Fire up FTP service like FileZilla.
  • Upload the codebase. By default, the code base will be deployed to /home/site/wwwroot directory

Final touches

  • On the left side menu of the App Service, navigate to "SSH" under Development Tools. This will open a web terminal. Navigate to web root:
   cd site/wwwroot
   php -r "copy('', 'composer-setup.php');"
   php -r "if (hash_file('sha384', 'composer-setup.php') === '756890a4488ce9024fc62c56153228907f1545c228516cbf63f885e036d37e9a59d27d63f46af1d4d07ee0f76181c7d3') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
   php composer-setup.php
   php -r "unlink('composer-setup.php');"
  • Install Laravel dependencies
   composer install
  • Create .env file
   mv .env.example .env
  • Generate application key
   php artisan key:generate
  • Replace database variables as below. Make sure to change variables under <> to reflect your details (details from creating SQL database step) (Use these if you went with Azure Database for MySQL)

(Use these if you went with Azure SQL Databases)

   DB_URL="sqlsrv:server = tcp:<YOUR_DATABASE_NAME>,1433; Database = <YOUR_DATABASE_NAME>"
  • Load the database dump
   php artisan db:seed --class=SqlDumpSeeder

Finally you can access your application at https://<YOUR_APP_SERVICE_NAME>


ORServices is an open source, smartphone-friendly directory application that enables you to collect, verify, organize and share information about social services in your community with your stakeholders, beneficiaries, partner organizations and more.




No releases published


No packages published