Skip to content
Renart Docs

Troubleshooting

Each entry starts with the message as Renart shows it.

Renart projects must live inside a Git repository

Section titled “Renart projects must live inside a Git repository”
Error: renart projects must live inside a git repository: no git repository found

Renart works inside a Git repository and refuses to start elsewhere. Create one in the project folder, then start Renart again:

Terminal window
git init
renart

Address already in use

Section titled “Address already in use”
Error: failed to listen on 127.0.0.1:9000: listen tcp 127.0.0.1:9000: bind: address already in use

Another program is using the port you passed with --port. Choose a different port, or leave --port out: on the default port, Renart moves to the next free port by itself and says so:

warning: 127.0.0.1:8080 is unavailable, using fallback port 8081 instead

This environment is protected

Section titled “This environment is protected”

Materialize is disabled with This environment is protected: interactive execution is disabled. The selected environment has the Protected guardrail, which blocks runs you start yourself. Switch to another environment in the top bar, or deploy the pipeline and let a schedule run it. See Execution guardrails.

Review run is blocked by a template

Section titled “Review run is blocked by a template”

Review run lists a problem for an asset, such as:

Failed to render template: invalid Jinja syntax: expected name or integer (Line: 8 Col: 14, near "}}")

A Jinja expression in that asset is incomplete, for example {{ var. }}. Choose View source to open the asset at that line, fix the expression, and check the result in the Render tab. See Variables and Jinja in SQL.

An asset stays stale after it was built

Section titled “An asset stays stale after it was built”

If you built a single asset while its upstreams were out of date, it still reads the outdated upstream tables. Rebuild with Review run, which opens on the out-of-date assets, or choose Build upstreams first when Renart asks. See Rebuild only what changed.

Section titled “Related”