Networking & Installation

Installing Lightspeed OnSite is a fast and simple procedure. Before you install, make sure your network and hardware meet the requirements for installing Lightspeed OnSite and Lightspeed OnSite Server.

You must be logged into OS X as an Administrator to install Lightspeed OnSite.

Your initial installation contains the Lightspeed OnSite Server, where your data resides, and the Lightspeed OnSite Client, the application that accesses that data. If you want to access Lightspeed OnSite Server from other computers, you must copy the Lightspeed OnSite Client to the Applications folder of other computers.

Network Preparation

  1. Your server must be on a network. A wired 100/1000 connection is recommended.
  2. The server should have a static IP on the local network. Contact your network administrator if you are not sure.

Lightspeed OnSite Server and Client Requirements

Click here for the system requirements.

Configuring a firewall to allow access to Lightspeed OnSite

Firewalls help prevent unauthorized access to computer resources, but need to be configured to allow access to applications. To access Lightspeed OnSite through a firewall, it is necessary to configure the firewall for the version of Lightspeed OnSite installed on the server computer. Lightspeed OnSite is compatible with the firewall included with Mac OS X Server as well as most third-party firewalls, however the firewall that ships with the regular client version of Mac OS X is not compatible as it does not allow for manual configuration of connections.

Lightspeed OnSite 3.0 and later

To enable connections to Lightspeed OnSite Server, included in Lightspeed OnSite 3.0 and later, the firewall must be configured to allow connections on the TCP port being used by Lightspeed OnSite. This port is 9630 by default, but should be confirmed before the configuration process by following these steps on the computer running Lightspeed OnSite Server:

  1. Go to Apple > System Preferences > Lightspeed Server.
  2. Select the licensed Lightspeed OnSite Server installation from the list on the left, and note the port number shown on the right. This is the TCP port that must be configured to allow incoming connections for Lightspeed OnSite clients.

Lightspeed OnSite 2.9.2 and earlier

To enable connections to Lightspeed OnSite 2.9.2 and earlier through a firewall, you must configure the firewall to allow connections from TCP ports 20221-20230. This lets Lightspeed OnSite clients connect to the OpenBase database that powers these versions of Lightspeed OnSite.

For information about firewalls and their configuration, we recommend that you seek assistance from network specialists. Payment Card Industry Data Security Standards (PCI-DSS) requirements prevent Lightspeed from providing assistance or advice about networking or firewall configurations.


To install the Lightspeed OnSite Server and Client:

  1. Download the Lightspeed installer here.
  2. Double-click the downloaded .dmg file to open the Lightspeed OnSite installer.
  3. Drag the Lightspeed OnSite Client to your computer’s Applications folder.

  4. Double-click Install Lightspeed Server, and follow the onscreen instructions to complete the server installation.
    Note: During the installation you are asked whether you want to install the demo or licensed version. Choose to install a licensed version, and enter your Lightspeed OnSite license key when prompted. If you’re upgrading from Lightspeed OnSite 2.x, this option is Migrate Database.

  5. When the installation is complete, launch Lightspeed OnSite by clicking the Lightspeed OnSite Client (Lightspeed) from the Applications folder.
  6. When the login screen appears, enter your username and password, and then click Connect.
    By default the username is lightspeed and the password is admin.

Additional Client Computers

Copy the Lightspeed OnSite Client to any client computers that will be accessing the server. Do not run the installer on client-only computers. Launch Lightspeed OnSite, click Servers, and then click Bonjour. Your client will detect the Lightspeed OnSite database on your network. Select the licensed database, enter the username and password, and then click Connect. If you want to connect to your Lightspeed OnSite server using a direct IP, see below for instructions.

Optimizing Performance

When you install the Lightspeed OnSite Server, the installer automatically configures your computer to ensure optimal performance with Lightspeed OnSite. To verify if your server computer is optimized for Lightspeed OnSite, or to re-optimize your computer after making changes to your system:

  1. Go to Apple > System Preferences > Lightspeed Server.

  2. If required, unlock the Lightspeed Server preferences by clicking the Lock icon and entering your system username and password.

  3. Click Advanced. The optimization window appears.
  4. If your computer is not optimized for use with Lightspeed OnSite, click Reset Configuration.

Lightspeed OnSite Server

As a multi-user, multi-store application, Lightspeed OnSite requires some minor configuration of your network settings in OS X  and Lightspeed OnSite Server System Preferences. Running Lightspeed OnSite on a central server is a simple process, but you should make sure that the hardware meets the system requirements before proceeding with your installation.

After Installation

  1. Go to Apple > System Preferences > Lightspeed Server.

  2. Select the database and note the port listed to the left. You should see all the licensing details for the add-ons you have enabled, including Multi-Store and Web Store (eCommerce).
  3. To allow client computers to access the Lightspeed OnSite server on your LAN, your network administrator must open this port on your router.
  4. You are now ready to begin using Lightspeed OnSite. See Start Here for more information.