Step 4

Run your first app

~7 minutes
Marks this step as complete and saves your progress

Now let's run the demo application! If you followed Step 1, you already have the demo project cloned. Let's start all services with a single command.

Start All Services

From the demo project folder, run:

bash 
# Make sure you're in the demo project
cd azd-app-demo

# Run the application
azd app run

This command will:

  • Build all services in your project
  • Start containers for databases and other dependencies
  • Launch your application services
  • Open the azd-app dashboard in your browser

Expected Output

Starting azd-app...

Building services...
✓ api built successfully
✓ web built successfully

Starting dependencies...
✓ postgres started on port 5432
✓ redis started on port 6379

Starting services...
✓ api started on http://localhost:5000
✓ web started on http://localhost:3000

Dashboard: http://localhost:5050

Press Ctrl+C to stop all services.

Access Your App

Once running, you can access the services at the URLs shown in the terminal output. The dashboard URL is displayed as well (typically at port 4280).

Try It Yourself

Run `azd app run` and wait for all services to start. Then open the dashboard URL shown in the terminal.

Expected: You should see the azd app dashboard with a list of running services and their health status.

Running Specific Services

You can run only specific services:

bash 
azd app run --service api,web

Open Dashboard in Browser

Automatically open the dashboard in your default browser:

bash 
azd app run --web

Verbose Output

Enable detailed logging to debug issues:

bash 
azd app run --verbose

Dry Run

Preview what would be executed without starting services:

bash 
azd app run --dry-run