Developer Golden Path

Use this path to move from a clean local checkout to the documented Lariba Cloud workflow surfaces.

1. Install dependencies

Use development-only credentials and services.

Follow PostgreSQL Bootstrap and confirm that the local database is reachable.

Inspect the migration state before applying schema changes.

From the backend directory, run the API process in the local development environment:

LARIBA_PROCESS_ROLE=api uvicorn src.main:app --host 0.0.0.0 --port 8000

Continue with Authentication.

Use a development identity and development credentials.

Keep source credentials private and rotate or revoke them when needed.

Verify that the event appears in the intended development project.

Continue with Sentinel.

If a step fails, use Troubleshooting before changing migration state or bypassing a failed check.

This guide is for local development. Production changes require the production deployment and operations procedures for the target environment.