Kompletny wykaz parametrów głównego pliku konfiguracyjnego serwera Neos (*.smd), opracowany na podstawie kodu serwera (stan: sierpień 2026).
Podział ról w dokumentacji: ta strona to referencja (szybki lookup — co istnieje, wartości domyślne, format), natomiast Plik esystem.smd to przewodnik scenariuszowy (jak skonfigurować konkretną funkcję, przykłady, wymagane wersje). Wzorcowy plik startowy: Instalacja i konfiguracja.
Zakres: parametry technologii serwera Neos. Wykaz nie obejmuje sekcji konfiguracyjnych pluginów zewnętrznych (np. shippingi, sterowniki e-commerce), projektów neosowych (np. [TDAPI_RecordsPerPage]) ani wpisów customowych konkretnych wdrożeń.
Format pliku: INI — sekcje [Nazwa], wpisy Klucz=Wartość. Komentarz: # na początku linii.
Automatyczna migracja starych kluczy — przy otwarciu pliku serwer przepisuje stare wpisy do nowych lokalizacji (o ile nowy klucz jeszcze nie istnieje; stary wpis nie jest usuwany):
HttpServerServiceAdress (literówka, z [AppService] lub [HTTPServer]) → [HTTPServer] HttpServerServiceAddress; analogicznie WebsocketServerServiceAdress; ODataServiceAdress — tylko z [AppService];
z [AppService] do [HTTPServer]: MaxThreadsForHttpServer, EnableHttpCaching, EnableHttpLongAuth, HttpLongAuthTimeout, WWWLoginTry, WWWBlockLoginInterval, WWWEnableHttps, ClientWWWDevMode.
Automatyczne szyfrowanie haseł — wartości poniższych kluczy serwer szyfruje w pliku przy pierwszym odczycie (AES): [Database:*] Password, [SmtpConfiguration] Password, [ThuliumAPI] RestPassword, [Telemetry] ESPassword, [EDA] PersistancePassword. Pozostałe hasła (np. [EDA] RabbitMQPassword, [Indexer] Password) pozostają jawne.
Sekcje dynamiczne: [Database:<alias>], [Profile:<nazwa>], [VirtualDir:<nazwa>], [EDA:<typ>]. Klucze dynamiczne: ProjectPath:<branch>, DefaultProject:<branch>, <id>:Name w [Plugins], <dysk>:Path w [Disks], <Projekt>.<Rola>:Port w [Webservices], warianty per-język Name:<jęz>, TabTitle:<jęz>.
Klucze profilowe a globalne — dwa mechanizmy:
fallback per-klucz: brak klucza w [Profile:x] → obowiązuje wartość globalna (ShowErrorDetails, FormButtonsLeftAlign, PublicViewSettingsAvailable, GlobalSearch*, DefaultLanguage, DefaultDatabase);
sekcja „albo-albo": gdy sesja ma profil, czytana jest wyłącznie sekcja [Profile:x] (brak klucza → wbudowana wartość domyślna); wariant z [Configuration] obowiązuje tylko dla sesji bez profilu (UsesDepartments, LoginProcedure, ChangePasswordProcedure, UserEmailProcedure, ResetPasswordProcedure, ResetTokenExpireTime).
SimpleSessionSettings (patrz [AppService]) — jeśli ustawiony, nadpisuje indywidualne parametry sesji (SessionsSweepInterval, RemoveDeadSessionsAfter, SessionsPingInterval, RemoveInactiveSessionsAfter, AccessTokenDuration, RefreshTokenDuration, LogoutTokenPolicy).
Zbiorcza polityka sesji (opis: Plik esystem.smd). Gdy ustawiona — nadpisuje indywidualne parametry sesji; pominięty token → wbudowane wartości (valid 30 min, inactive 20 min). Liczba bez przyrostka jednostki jest interpretowana jako 0 minut — zawsze podawaj m/h/d.
SessionsSweepInterval
wyliczany (1–15)
minuty
Jak często serwer przegląda sesje w poszukiwaniu martwych/nieaktywnych.
RemoveDeadSessionsAfter
60
minuty
Po jakim czasie bez sygnału życia klienta sesja jest uznawana za martwą (usuwana po dwukrotności tej wartości).
InactivityPeriod
—
minuty
Starsza nazwa RemoveDeadSessionsAfter — czytana tylko, gdy nowego klucza brak.
SessionsPingInterval
wyliczany (≤60)
minuty
Jak często klient ma informować serwer, że żyje (wartość przekazywana klientom przy logowaniu).
CodeEditorServiceAddress
—
host:port
Adres usługi nowego edytora kodu C# (Monaco); brak lub błędna wartość = powrót do starego edytora.
CodeEditorRefreshMechanism
websocket
websocket/ibevent
Mechanizm odświeżania klienta Desktop po zmianie kodu.
FooterCssPath
—
ścieżka CSS
Arkusz stylów stopki strony startowej klienta WEB.
Bazy danych są wykrywane na podstawie sekcji [Database:<alias>]. Baza system (sterownik MEM) jest dokładana automatycznie, jeśli nie zdefiniowano jej w pliku.
Klucz
Domyślnie
Format
Opis
DatabaseDriver
—
FB/MSSQL/MEM
Sterownik bazy danych.
DatabaseFile
—
connection string
Ścieżka/connection string bazy. Dla MSSQL wartość jest dzielona po pierwszym : na serwer i resztę (reszta ze znakiem \ jest traktowana jako ścieżka pliku, bez — jako nazwa bazy).
DatabaseHost
—
host[,port]
Host serwera DB (alternatywa dla DatabaseFile przy MSSQL, razem z DatabasePath).
DatabasePath
—
nazwa bazy
Nazwa bazy po stronie serwera (MSSQL).
DatabasePort
0
port
Port serwera DB; 0 = domyślny port sterownika.
DatabaseConfFile
—
ścieżka
Plik schematu bazy (np. esystem.dbi).
DatabaseCharset
—
WIN1250/UTF8
Kodowanie połączenia.
User / Password
—
login/hasło
Dane logowania (hasło jest automatycznie szyfrowane w pliku).
DatabaseRole
—
rola DB
Rola bazodanowa, z którą nawiązywane jest połączenie.
EnablePooling
yes
dokładnie yes
Pula połączeń. Wartość porównywana z rozróżnianiem wielkości liter — Yes/YESwyłącza pooling.
MaxConnections
100
liczba
Maksymalna liczba połączeń w puli.
MaxConnectionLifetime
15
sekundy
Czas życia bezczynnego połączenia w puli.
ReadOnlyTransactionDefault
no
yes/no
Domyślne otwieranie transakcji zapytań w trybie tylko-do-odczytu.
ReadIsolationLevel / ReadWriteIsolationLevel
wartości globalne
poziom izolacji
Poziomy izolacji per baza (nadpisują [Configuration]).
Wiersze sekcji definiują ścieżki wyszukiwania plików definicji, w formacie: [:poziomDev:] katalog maska [maska...] (poziom dev jest opcjonalny). Przykład: dbi *.dbi. Brak sekcji nie przerywa startu serwera — skutkuje dopiero błędami przy wyszukiwaniu plików definicji (np. .dbi).
Ścieżka URL i fizyczny katalog wirtualnego katalogu (nazwy z [HTTPServer] VirtualDirs).
[Migrations]
Recompile
1
Przy 1 do skryptu migracji doklejana jest rekompilacja metadanych bazy.
[EDEManager]
PrepareFilesPath
—
Katalog roboczy mechanizmu EDE (elektroniczna wymiana dokumentów).
[PrintingService]
ExeName / WorkingDirectory / IniFile
—
Proces serwera drukowania (VCL sserver) uruchamiany jako podproces.
[RemoteClient]
CheckWorkingParamsTimerPeriod
0
Okres (ms) odpytywania serwera o parametry robocze przez klienta zdalnego Neos↔Neos; 0 = wyłączony.
Wpisy historyczne — nieodczytywane przez aktualny serwer¶
Poniższe klucze bywają spotykane w plikach smd i starszej dokumentacji, ale aktualne wersje serwera ich nie odczytują:
[Configuration]: Databases (bazy wykrywane po sekcjach [Database:...]), LogMode, DebugOnStartup, DebugTransactions, MaxArchiveFiles, LogDir (logowanie konfiguruje się w neos_logger.json; klucz Neos:LogMode w tym pliku przyjmuje ten sam format flag co dawny LogMode), AutoReconnectDBEnabled, AutoReconnectDBCronExpression, DatabasesCheckExistingFields;
[AppService]: SecondsForQueryDatabase, EnableHttpLongAuth, HttpLongAuthTimeout (mechanizm zastąpiony kluczami sesji od wersji 4.7);
[HTTPServer]: PlainHttpServer;
[Database:x]: EnablePartialFill, AutoCommitTimer, ConnectionPoolerPolicy, ConnectionPoolerPolicyCloseNotUsedAfter (nieobsługiwane od wersji 6.0);