Windows Service Setup

Run as a Windows Service

This guide covers how to set up Floating Server V2 to run as a Windows service using SQLite as its database backend.

Prerequisites

• Floating Server V2 executable
• A valid default.yaml configuration file
• Administrator access on the Windows machine

1

Place the Floating Server in a Directory

Create the following directory structure:

C:\LS\
├── floating-server.exe
└── config\
    └── default.yaml

2

Update the Configuration

In default.yaml, configure the database section as follows:

database:
  type: sqlite
  path: ./data/db.sqlite  # configure path as needed

3

Confirm the Server Runs Manually First

Before setting up the Windows service, confirm the server starts correctly. Open PowerShell and run:

cd C:\LS
.\floating-server.exe

If the server fails to start manually, resolve the issue before proceeding with the Windows service setup.

4

Download and Prepare WinSW

Download WinSW-x64.exe and move it to C:\LS. Rename it to fs2-service.exe.

The WinSW executable and the XML configuration file must share the same base name:

• fs2-service.exe
• fs2-service.xml

5

Create the Service Configuration File

Create the file C:\LS\fs2-service.xml with the following content:

<service>
  <id>LicenseSpringFloatingServerV2</id>
  <name>LicenseSpring Floating Server V2</name>
  <description>Runs the LicenseSpring Floating Server V2.</description>
  <executable>C:\LS\floating-server.exe</executable>
  <workingdirectory>C:\LS</workingdirectory>
  <startmode>Automatic</startmode>
  <delayedAutoStart>true</delayedAutoStart>
  <logpath>C:\LS\logs</logpath>
  <log mode="roll"></log>
  <onfailure action="restart" delay="10 sec"/>
  <onfailure action="restart" delay="30 sec"/>
  <onfailure action="restart" delay="60 sec"/>
</service>

6

Install and Start the Service

Open an Administrator PowerShell and run:

cd C:\LS
.\fs2-service.exe install
.\fs2-service.exe start
.\fs2-service.exe status

The Floating Server V2 is now running as a Windows service and will start automatically on system boot.