Running & Administration

Starting the Server

Once your configuration file is ready, you can start the Floating Server in one of the following ways:

Method 1: Executable

If you are using the executable, run the binary matching your operating system:

./floating-server

Method 2: Docker

1

Pull the image

docker pull licensespring/floating-server-v2:v2.0.0-beta.1

2

Set up PostgreSQL

• Start a PostgreSQL instance (local or containerized).

• Note the host, port, username, password, and database name.

• Update your configuration file with these details.

3

Prepare configuration and certificates

• Place the configuration file in a local directory.

• Place certificates in another directory.

4

Run the container

Mount both the configuration and certificate directories so that the container has access:

docker run -d  \
--name fsv2 \
--network fsnet \
-v /path/to/config:/app/config \
-v /path/to/certs:/app/certs \
-p 8080:8080 \
licensespring/floating-server-v2:v2.0.0-beta.1

5

Notes

• Replace /path/to/config with your config directory.

• Replace /path/to/certs with your certificates directory.

• Adjust -p if exposing on a different port.

• Replace /path/to/config with your config directory.

• Replace /path/to/certs with your certificates directory.

• Adjust -p if exposing on a different port.

Method 3: Docker Compose

A prebuilt docker-compose.yml is included in the documentation. Running it sets up both PostgreSQL and the Floating Server in one step:

docker-compose up -d

This is the fastest way to get everything running.

First-Time Admin Setup

When the server starts for the first time, no users or admins exist. You must set the initial admin password.

• Default username: admin

• Password: defined during setup.

Setting the Password

You can set it via:

1

UI

Navigate to the Floating Server’s URL. You’ll be redirected to the password setup page.

Running the Floating Server for the first time: Setting initial Admin Password

2

API

Call the endpoint:

POST /api/v5/auth/initial-password

Logging In

Once the initial password is set:

• Log in using admin and your chosen password.

• You will then access the Floating Server admin panel.

Image of the Floating Server Running

• From here, you can create additional user accounts.

After starting the server:

• Executable: A log file is generated automatically.

• Docker: Use docker logs to view server output.