Troubleshooting 🆘¶

Running Field-TM standalone¶

Although it's easiest to use Docker, sometimes it may no be feasible, or not preferred.
We use a tool called uv to manage dependencies.
Be careful when running Field-TM you are not accidentally pulling in your system packages.

Tips¶

Troubleshoot the packages uv sees with: uv pip list
Check a package can be imported in the uv-based Python environment:
```
uv run python
import litestar
```

If you receive errors such as:

pydantic.error_wrappers.ValidationError: 3 validation errors for Settings
OSM_URL
  field required (type=value_error.missing)
OSM_SCOPE
  field required (type=value_error.missing)

Then you need to set the env variables on your system.

Alternatively, run via just:

just start backend-no-docker