> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo-platform/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo-platform/_mcp/server.

# Troubleshoot Data Designer

<a id="trbl-ndd-dc" />

Learn how to troubleshoot common issues with NeMo Data Designer in a local NeMo Platform setup.

## Prerequisites

Before troubleshooting, make sure:

* The `nemo` CLI is installed and available: `nemo --help`.
* Local platform services are running from `nemo setup` or `nemo services run`.
* Your CLI context points at the workspace where the Data Designer job or fileset was created. Use `nemo workspaces list` to confirm available workspaces.

## Check Platform Health

Verify that the local platform API is ready:

```bash
curl -s http://localhost:8080/health/ready
```

If the health check fails, re-run setup:

```bash
nemo setup
```

## Check Service Logs

Local setup writes service output to `~/.local/state/nmp/instances/<scope>/services.log` in the directory where services were started.

```bash
tail -n 200 ~/.local/state/nmp/instances/<scope>/services.log
tail -f ~/.local/state/nmp/instances/<scope>/services.log
```

Look for startup errors, provider authentication failures, port conflicts, or Data Designer request failures.

## Common Issues

* **Port conflicts**: Ensure port `8080` is not in use by another local application.
* **Authentication**: Confirm that the model provider configured by `nemo setup` has a valid API key.
* **Network connectivity**: Ensure your machine can reach package indexes and configured model-provider endpoints.
* **No healthy upstream (503)**: A `503` response can mean services are still starting. Wait for readiness, then retry the request.
* **Dataset access**: Confirm that referenced filesets exist in the selected workspace and that remote dataset credentials are configured when required.

## Next steps

* Tutorial: [Data Designer Tutorials](/documentation/design-synthetic-data/tutorials) covers common generation workflows.
* How-to: [Set Up NeMo Platform](/documentation/get-started) covers local setup and service startup.
* Explanation: [Data Designer Overview](/documentation/design-synthetic-data) explains configuration, execution, and service behavior.
* Reference: [API Reference](/documentation/reference/api-reference) lists Data Designer endpoints.
* Troubleshooting: [Troubleshooting Overview](/documentation/reference/troubleshooting) links to other service troubleshooting pages.