Local development
Practical local startup and troubleshooting notes for Oximy services.
Start the docs app
pnpm --filter docs devOpen http://localhost:3102.
Start the dashboard
pnpm dev:dashboardThe dashboard defaults to http://localhost:3000.
Start all local services
pnpm dev:localThis uses local API URLs and avoids pulling dashboard secrets through Infisical.
Port map
| Service | Default port |
|---|---|
| Dashboard | 3000 |
| API | 4000 |
| Relay admin | 8700 |
| Docs | 3102 |
Troubleshooting
- If a port is busy, check existing Conductor workspaces before killing a process.
- If a dashboard dev command parses arguments incorrectly, prefer
pnpm --filter dashboard exec next dev --hostname 0.0.0.0 --port 3000. - If docs content does not appear, restart
pnpm --filter docs devso Fumadocs regenerates.source.