11-Sapphire Single User Settings and Procedures

Single User Application Overview

The Sapphire Single User Settings and Procedures article is designed for SapphireOne users as a step by step guide to be followed when installing or upgrading the Sapphire Single User application.

This Sapphire Single User application, operates as a stand alone application on either MacOS or Windows operating platforms. It may be used to access a Live Data file without the requirements of a SapphireOne Client Server application.

The Sapphire Single User application may be used in two ways.

  1. As a simple stand alone application for a small business where Client Server functionality is not required.
  2. As a sandbox to test a new version of SapphireOne, or to test the Import of items into your data file using the following procedure.
    1. The user would get a copy of their live data file from the SapphireOne server.
    2. Then access the copy of the live data file with the normal log in using Sapphire Single User.
    3. Test the importing of various items in to the copy of the live data file.
    4. When all is correct duplicate the import process using the live data file on the SapphireOne Server.

Downloading Files from SapphireOne’s File Station

Please note that we have closed our ftp server and replaced it with SapphireOne’s File Station.

This Sapphire Single User application should be installed in the same location on the hard drive of either a MacOS or Windows platform as SapphireOne’s Server or Client applications. It is also installed standalone on MacOS and for the Windows operating platform, it is not integrated into the Windows registry.

For Sapphire’s Single User application there are two version numbers, they are 4D and SapphireOne’s, so from we extract the following.

  • 4D Version numbers – These the the first two numbers. I.e 18.4
  • SapphireOne Version Numbers – The last two numbers. I.e 0.1

SapphireOne’s version numbers do increment on a regular basis in the Single User builds, as the entire folder structure is replaced when SapphireOne releases a new build. For SapphireOne’s Server, only the Server Database folder is replaced.

The Single User application is platform dependent so the user will select either the MacOS or Windows version for download as required. There will only be two files in the Single User folder on SapphireOne’s File Station. One for MacOS and another for the Windows platforms.

  • MacOS File – which will unpack to Sapphire
  • Windows File – which will unpack to Sapphire

Note carefully the unpacked folders for a MacOS and Windows.

  • MacOS – While the MacOS folder has Mac at the end of the folder name it will contain the usual Mac named file, Sapphire 18.4.app The user will have to right click on the folder, and select Show Contents from the mouse right click context menu, to view the contents of the folder.


Files may now be downloaded from SapphireOne by using a web browser. Documentation for this procedure my be found on our Knowledge Base by going to our article on the SapphireOne File Station.

Each of our Clients has access to an individual Client folder, where they, and they only, may upload or download backup copies of their data files to these folders. There is also a common area where all files in the common Download folder may be down loaded, but no uploads are allowed. This is where the files in this article are stored in SapphireOne’s File Station.

For example the 4D Server Application, 4D Client application and SapphireOne builds, are all in separate folders for your convenience. Select and download the required files before starting the upgrade procedure documented from here on in this article.

For each platform the file size of the 4D Client application is between 170 and 210Mb.

The Sapphire Single User application MUST be run locally on a local computer and not from a shared/network drive. The Sapphire Single User application stores information in the folders that are below where the application is executed from and as such MUST have full and sole control of all sub folders.

As the Single User application is platform dependent, each file as it is downloaded and unpacked, will only have a single folder containing all files need for the installation.

The installation file once downloaded will unpack to a single folder with all files required contained inside that folder. Installation is just the copying of that folder and its contents into a single location on the workstation.

  • Several decisions will have to be made before downloading Sapphire’s Single User application as follows. Where on the workstation should Sapphire’s Single application be placed.
    SapphireOne recommends the following locations for a MacOS or Windows.
    • MacOS – Create a folder named SapphireOne in the Applications Folder.
    • Windows – Create a folder named SapphireOne in the Program Files folder
  • When the unpacked folder is dropped into the SapphireOne folder the result should be as seen below in the screen shot. Both MacOS after using, Show Contents, and Windows folders are displayed below. The folder layouts for both platforms are the same except the MacOS hides the subfolders.


While Sapphire’s Single User application may be executed from any folder on a computer’s hard drive, we strongly recommend that the folder is installed as in the screen shot above.

For the Initial installation process the user has two choices.

  • Single User – Download it from SapphireOne’s File Station to then copy the Sapphire’s Single User folder into the required location on the local computer’s hard Drive.
  • Shortcuts- When initially installing Sapphire’s SIngle User Application onto any computer short cuts should be created.
    • MacOS – In the folder, locate the 18.4.app file. Right mouse click and select the Make Alias option.
    • Windows – In the folder, locate the Sapphire.exe executable. Right mouse click and select one of the create shortcut option from the mouse context menu.

As each build is released by SapphireOne the procedure above will have to be repeated.

You can review our Blog and YouTube channel for additional information and resources on SapphireOne ERP, CRM and Business Accounting software.

Was this helpful?