Getting Started
The following pages will provide you with the first stepping stones when starting to work with Firely server. You can install Firely Server locally in a matter of minutes for testing purposes.
Basic installation
Note
Firely Server can run on all operating systems that support .NET. If your OS does not support .NET or if you want to use Docker, please look at the Using Firely Server on Docker section.
If you want to start using the standard Firely Server in your local environment, follow the steps on this page to install
and run the server.
Sign up for an evaluation license. You will receive an email with the license file as well as a link to the download page where you can download the Firely Server binaries with the version of your choosing.
Extract the downloaded files to a location on your system, for example:
C:FirelyServer. We will call this the working directory.Put the license file in the working directory.
In the working directory create a new JSON file and name it
appsettings.json. You will use this file for settings that you want to differ from the defaults inappsettings.default.json. For more background on how the settings are processed, see Adjusting Firely Server settings.Open
appsettings.json, copy theLicenseFilesetting fromappsettings.default.jsonto it and change this property to the name of your license file. For example:{ "License": { "LicenseFile": "firelyserver-trial-license.json" } }
You can further configure Firely Server by adjusting the
appsettings.json. The section Setting up Firely Server explains possible configuration settings.
Running Firely Server
Important
The next step assumes you have a .NET environment installed. If not, please download and install ASP.NET Core Runtime 10.x.xx Hosting Bundle before you continue. Choose the latest security patch to mitigate security issues in previous versions.
Firely Server requires .NET 10 as of version 6.9.0. Older releases require .NET 8 (Firely Server 5.7.0 up to and including 6.8.x) or .NET 6 (Firely Server 5.6.x and older).
When you have completed your configuration changes, start the server. Open a command prompt or Powershell, navigate to your working directory and execute:
> dotnet .\Firely.Server.dll
Access Firely Server
Firely Server will by default run on port 4080 of the system. Check if Firely Server is running correctly, open a browser and navigate to localhost:4080.
Guided setup
When launching Firely Server for the first time with default configuration, a welcome screen displays the current status of four key components: Database backend, Authentication & SMART, HTTPS/TLS, and Audit logging. Items requiring attention (such as SQLite or unauthenticated endpoints) are flagged in amber.
You can proceed in one of two ways:
Set Up My Server: Opens the guided setup wizard to generate custom configuration files.
Explore Default Configuration: Closes the onboarding screen and launches the server using default settings (SQLite, unauthenticated over HTTP; recommended for testing only).
If you select Explore Default Configuration or haven’t modified appsettings.instance.json yet, the home page will display a Start Guided Setup button so you can run the wizard at any time.
Using the setup form
Navigation: Use the left sidebar to jump between the 9 setup steps, or click Next / Previous at the bottom. The book icon next to step titles opens the relevant documentation.
Defaults & Reset: Click Reset To Default to restore settings for the active step (unavailable on Advanced Features and Preview & Export).
Validation & Indicators:
Red dot: Validation error that must be resolved before exporting.
Amber warning: Non-blocking warning (e.g., SQLite selection).
Greyed-out switch: Feature unavailable for your current license or database choice.
Note
The guided setup generates configuration files without modifying the live server directly. Settings are applied only after downloading the generated files and restarting the server.
Exporting and applying configuration
The final step, Preview & Export, shows generated configuration files containing only your customized settings:
File |
Content |
|---|---|
|
Customized server settings |
|
Customized logging settings (if changed) |
|
Environment variables for sensitive values (if enabled) |
To apply your changes:
Click Download Configuration Files (or Download as ZIP) and save them to your Firely Server root folder.
Restart Firely Server:
Standard setup: Perform a normal server restart.
With an
.envfile: Execute the platform-specific restart command displayed on the export screen (Linux/macOS, PowerShell, or Docker).
For manual configuration, see Adjusting Firely Server settings. To explore features, see Features - Overview.