Help

Troubleshooting

The templates or the SDK are not found

dotnet new install Kofa.Komod.Template → "not found": the KOFA NuGet source is missing. Add it (dotnet nuget add source https://kofa.kncsk.hu/nuget/v3/index.json --name kofa) and check it with dotnet nuget list source.

Restore error: Kofa.Abstractions not found: the project does not see the source. A nuget.config is created next to the template; if it is missing, or another nuget.config overrides it, add the kofa source back.

The package cannot be installed

Message	What to do
The UI assembly is missing	Build the `.Ui` project first, then the server (`-p:KomodPack=true`).
The change does not take effect after a reload	Reloading the same version is a reinstall; raise `KomodPackageVersion` and refresh the browser.
Load error: port type	A High relay priority port cannot carry raw bytes (Relay).
`MissingMethodException` / `TypeLoadException` in the browser, "uses a part of .NET that was trimmed from this client"	The UI uses a framework API that is not in the trimmed client (the message names it); `kofa-pack` and the program export warn. Avoid the API or move it to the server side.
"needs a newer KOFA framework"	The UI refers to a `Kofa.Abstractions*` type or member newer than the client's: update the app / the client.

The Komod does not appear in the palette

The class with the [Komod] attribute must be public and derive from KomodBase<>.
The package must be enabled on the Komodok page; an extension (Kind = Extension) does not go to the palette.
On a running server: Rescan folders.

The Komod stops with an error (`Faulted`)

Look at the instance's status line and the server log.
"busy: used by instance 'X'": two instances would ask for the same hardware resource (Hardware).
A settings validation error: a rule such as [Range] of the record is violated; the graph reports it before Apply.

A link cannot be dragged

The type or major version of the two ports does not match (Ports). A converter Komod is needed between them.

The tile does not update

The port id in the subscription must match the server's [Output]/[Input] id (case matters).
A changed UI dll with the same version takes effect only after a page refresh.
On a relay, None/Blocked ports may be empty (Relay).

Memory grows after hot reload

Check that you do not use a reflection-based JsonSerializer with default options and that there is no static cache or event handler in the Komod (Files). Native code cannot be unloaded (Native).

Can't find it? Describe the problem on the Komod store site, or ask the KOFA developers.