Kamailio Routing Script
Language support for the Kamailio routing
script (kamailio.cfg) — the real Kamailio parser checks your
config as you work, and completion, hover documentation, and
navigation come from the actual documentation of your Kamailio
version. Platform builds bundle the language server: install the
extension and it just works.
Features
- Diagnostics you can trust — every save runs
kamailio -c, so
the squiggles are the real parser's verdict, at the exact line
and column, for exactly your Kamailio version — misspell a modparam
name (fr_tmer for tm's fr_timer) and that line is flagged with
Can't set module parameter.
- Completion that knows context
loadmodule " → every module in your source treemodparam("tm", " → tm's parameters, with their documentation- inside a route → exported functions of the modules you loaded,
plus core functions, parameters, route names, and keywords
$ → pseudo-variables ($ru, $si, …) with descriptions- functions insert as snippets — the cursor lands between the
parentheses
- Hover documentation for functions, parameters, modules, and
pseudo-variables, harvested from Kamailio's own docs.
- Navigation — Ctrl+Click
route(NAME) to jump to its
definition (even into an include_file); Ctrl+Shift+O lists every
route block with its full extent; route blocks fold.
- Signature help — type
( or , in a call and the signature
pops up with the active parameter highlighted.
- References & rename — Shift+F12 lists every call site of a
route; F2 renames it everywhere, quoted call sites included.
- Instant warnings — undefined
route() targets and duplicate
route definitions are flagged as you type, no save needed.
- Snippets —
route, failure_route, ifmethod, modparam,
switch, xlog, and more.
- Safe by default — in untrusted workspaces diagnostics stay off
(checking a config loads its modules); everything else keeps
working.
Quick start
- Install this extension (the platform packages bundle the server —
Linux, macOS, and Windows, x64 and arm64).
- Open a folder containing a
kamailio.cfg — syntax colors,
completion, and navigation work immediately.
- For live error checking, point
Settings → Kamailio Lsp: Kamailio Path at your
kamailio
binary and save the file.
- For the richest completion docs, set Kamailio Src to an
Kamailio source tree matching your version.
New to all of this? The step-by-step
Getting Started guide
covers installation and usage click by click.
Settings
| Setting |
Default |
Effect |
kamailioLsp.enable |
true |
Master switch. |
kamailioLsp.serverPath |
bundled |
Server binary override. |
kamailioLsp.kamailioPath |
kamailio |
Binary for -c diagnostics; empty disables. |
kamailioLsp.kamailioSrc |
— |
Source tree for module completion/hover docs. |
kamailioLsp.kamailioWiki |
— |
kamailio-wiki checkout for core-language docs. |
kamailioLsp.modulesPath |
— |
Module search path for the checker (-L). |
kamailioLsp.diagnostics.enable |
true |
Toggle checks without losing the path. |
kamailioLsp.diagnostics.analyzer |
true |
As-you-type analyzer warnings. |
kamailioLsp.diagnostics.maxProblems |
100 |
Diagnostics cap per file. |
kamailioLsp.checkTimeoutMs |
10000 |
Bound on one -c run. |
kamailioLsp.completion.snippets |
true |
Function completions as snippets. |
kamailioLsp.cacheDir |
platform |
Documentation-cache location. |
kamailioLsp.trace.server |
off |
LSP traffic tracing. |
Full reference:
Features & Settings.
Requirements
None to start — the server is bundled. Optional, for the full
experience: an kamailio binary (diagnostics) and a Kamailio source
tree plus a kamailio-wiki checkout (documentation). Version-proven
against Kamailio 6.0.x.
Links
Repository ·
Getting Started ·
Admin Guide ·
Issues ·
Releases
Dual-licensed MIT or Apache-2.0.
| |
