Overview & Installation

the v2 of the floating server is currently in an open beta please submit any bugs or feedback via our support tickets as we are actively working to resolve them to move to an initial public release in a timely manner what is the floating server v2? the floating server is licensespring’s self hosted licensing platform, providing the core features of the cloud platform locally version 2 introduces improved setup, configuration, and management workflows to make deployment, provisioning, and administration easier this document focuses on v2, detailing installation, configuration, and best practices for running the floating server in your environment key highlights & compatibility feature details supported platforms windows and linux supported sdks (initial) c++, net, java (more coming) database support sqlite (dev/test), postgresql (prod) production recommendation postgresql provisioning options certificates or yubikey tokens installation options option 1 native executable (recommended) download the appropriate binary floating server linux amd 2 0 0 beta 2 zip floating server windows amd 2 0 0 beta 2 zip unzip and run directly, no docker required option 2 docker image pull the image from docker hub run the container from the pulled image the configuration file and provisioning steps are identical for both methods the only difference with docker is that you must mount the configuration and provisioning files so the container can access them run floating server v2 with postgresql and docker create a shared network docker network create fsnet start postgresql docker run d \\ \ name fs postgres \\ \ network fsnet \\ e postgres user=fsuser \\ e postgres password=fspassword \\ e postgres db=fsdb \\ v pgdata /var/lib/postgresql/data \\ p 5432 5432 \\ postgres 16 change the setting as needed modify floating server config file yaml database type postgres host fs postgres port 5432 user fsuser password fspassword name fsdb sslmode "disable" pull the floating server v2 image docker pull licensespring/floating server v2\ v2 0 0 beta 2 run floating server v2 mount the config file and the certs (certificates and private key generated in provisioning) folder from provisioning docker run d \\ \ name fsv2 \\ \ network fsnet \\ p 8080 8080 \\ v "$(pwd)/config /app/config\ ro" \\ v "$(pwd)/certs\ /app/certs\ ro" \\ licensespring/floating server v2\ v2 0 0 beta 2 in this sample, we have assumed the confing file is located in /config and certificates and private key in /certs verify floating server api http //localhost 8080 postgres available at fs postgres 5432 inside the docker network docker compose the steps mentioned above are all inlucded in the following docker compose file place this file in the directory with folders config and certs , config containing default yaml (config file) and certs containing all the certificates and private key generated in provisioning and then run docker compose up d make any needed adjustments docker compose yaml services postgres image postgres 16 container name fs postgres environment postgres user fsuser postgres password fspassword postgres db fsdb volumes \ pgdata /var/lib/postgresql/data ports \ "5432 5432" networks \ fsnet healthcheck test \["cmd shell", "pg isready u ${postgres user fsuser} d ${postgres db fsdb}"] interval 5s timeout 5s retries 10 restart unless stopped fsv2 image licensespring/floating server v2\ latest container name fsv2 depends on postgres condition service healthy ports \ "8080 8080" volumes \ /config /app/config\ ro \ /certs\ /app/certs\ ro networks \ fsnet restart unless stopped networks fsnet name fsnet \# if you've already created fsnet with `docker network create fsnet`, \# uncomment the next line to reuse it instead of letting compose create it \# external true volumes pgdata