NOSH ChartingSystem

A new open source health charting system for doctors.

Download

Before proceeding with your download, please fill out this form.

NOSH ChartingSystem is now best installed as NOSH-in-a-Box. Even better, all of the components required are free to download and install! NOSH-in-a-Box is essentially a virtual machine installation. In other words, another computer operating system, which is called the guest, is working inside your original computer operating system, which is called the host. This guest is called NOSH-in-a-Box, which is a pre-packaged version of the latest Long-Term-Support release of Ubuntu that has only the necessary dependencies that NOSH ChartingSystem needs so that it will work right out-of-the-box without any likelihood of mess ups or failures during the installation. Furthermore, the host operating system can be either Windows, Mac, or any Linux distribution since it relies on VirtualBox and Vagrant to do the virtual machine generation and loading.

Step 1: Preparation

  1. Make sure you have a valid Google Gmail account so that you can send emails and SMS text messages from NOSH ChartingSystem. Instructions are here.
  2. Make sure you have a domain name registered and linked to the IP address where NOSH-in-a-Box is connected to. You can get a crazy cheap one ($0.88/year) at Namecheap. They have great instructions for how to do this.
  3. If your NOSH-in-a-Box is installed physically and is behind a network router, make sure port forwarding is set for ports 22 (for SSH), 80 (for HTTP), and 443 (for HTTPS) going to the local area IP address for NOSH-in-a-Box.

Step 2: Download and install VirtualBox

Builds are available for Windows, Mac, and Linux

Make sure you download and install the VM VirtualBox Extension Pack as well. Once installed, open up VirtualBox, click on File and then Preferences. Click on Extensions. Click on the icon on the right hand side that looks like an orange arrow pointing downwards and select the recently downloaded extension pack to install it.

Step 3: Download and install Vagrant

Builds are available for Windows, Mac, and Linux.

Step 4: Download and install Git

Builds are available for Windows, Mac, and Linux.

Extra Step for Windows: Download and install cmder

Also download, unzip, and run this agent.cmd file to turn on ssh-agent.

Step 5: Create a folder where you’re going to install NOSH-in-a-Box.

It doesn’t matter what you call it (C:\Users\Me\nosh, /Users/Me/nosh, or /home/Me/nosh). This folder is also where your NOSH database backups will be placed. Just remember what it is because you need it for the next step. For Windows only, make sure there are no spaces in the directory (like C:\Users\Me Too\nosh) as the plugin installation in step 8 will fail.

Step 6: Download the latest .ZIP release of NOSH-in-a-Box

Step 7: Unzip or extract the entire contents of the ZIP into the folder you created in step 3.

Important

If you are running NOSH inside a local area network and if you have a domain name assigned to your network, you need to make one change to Vagrantfile to allow users outside of your network to access NOSH. First you need to find the IP address of your router. These are the steps to find it.

Windows:

Click Start > All Programs > Accessories > Command Prompt.

When Command Prompt is open, type the following command: ipconfig | findstr /i "Gateway" (You can copy & paste it in the command prompt; just right-click anywhere in the command prompt window and select Paste.)

You should see something like this:

    C:\Documents and Settings\administrator>ipconfig | findstr /i "Gateway"
    Default Gateway . . . . . . . . . : 192.168.1.1

In this example, your default gateway (router) IP address is 192.168.1.1.

Linux:

You’ll need to open a Terminal. Depending on your Linux distribution, it can be located in the menu items at the top, or at the bottom of your screen. In this example, we will use Ubuntu__. Click Applications > System Tools > Terminal.

When terminal is open, type the following command: ip route | grep default

The output of this should look something like the following:

    joe$ ip route | grep default
    default via 192.168.1.1 dev eth0 proto static

In this example, again, 192.168.1.1 is your default gateway (router) IP address.

Mac OS X:

Open the Terminal application. To do this, click Finder > Applications > Utilities > Terminal.app.

When Terminal.app is open, type the following command: netstat -nr | grep default

This will output the following:

    joe$ netstat -nr | grep default
    default 192.168.1.1 UGSc 50 46 en1

In this example, again, 192.168.1.1 is your default gateway (router) IP address.

Once you have the router IP address, replace the item near the bottom of the Vagrantfile with the IP address that you have identified above. Then remove the # characters in 3 lines before the end line. This line starts with config.vm.provision "shell",

Step 8: Vagrant Up!

Open up a terminal and go to the directory you created.

  • On Windows, use cmder as installed above.
  • On Mac, open your Applications folder, then open the Utilities folder. Open the Terminal application.
  • On Linux, you probably already know how to get there 🙂

Then type this:

  • cd C:\Users\Me\nosh for Windows
  • cd /Users/Me/nosh for Mac
  • cd /home/Me/nosh for Linux

Then type this:
vagrant plugin install vagrant-vbguest

Then type this:
vagrant up

Grab something to nosh on since it will take a bit do build the virtual machine. You’ll return back to your command prompt when it is done. Now enter the virtual machine by the SSH (Secure Shell) command:
vagrant ssh

Step 9: First-time installation routine in your brand-new NOSH-in-a-Box.

When you first enter your SSH, you’ll be asked a series of questions.

Enter your username

This is self explanatory. Use this username when you are trying to login via SSH externally or to access phpMyAdmin.

Enter your MySQL password

Use this username when you are trying to login via SSH externally or to access phpMyAdmin.

Enter your domain name

Use the domain name (yourdomain.com) that you have registered on NameCheap. Leave this blank to register your SSL certificate at a later time.

Enter new UNIX password

Use this password when you are trying to login via SSH externally. Can be the same as your MySQL password.

Full Name

Enter your full name. Leave the others afterwards blank.

Is the information correct?

Type Y.

Grab something else to nosh on since it will take a bit do build install all dependencies and NOSH ChartingSystem itself.

It’s then going to ask you for an email address to register to Let’s Encrypt so that you can have a free SSL certificate (so you can access https://yourdomain.com/nosh)!

Step 10: Go to your NOSH ChartingSystem website to complete the last part of the installation

Go to https://yourdomain.com/nosh

If you’re inside your local-area-network (LAN), you may have errors getting into NOSH ChartingSystem by using the domain name because your router is configured not to allow external addresses to reach internal address. To circumvent this, go back to the terminal where the last installation routine took place (you’ll see a command prompt) and type in the URL with a numerical IP address in the end of the installation script such as.

https://192.168.1.152/nosh