Logs & Terminal

Deployment logs

When a deployment is triggered, QuickStack streams Kubernetes events (pod scheduling, image pulls, container starts and stops) directly into the deployment log alongside the build output. This provides additional context when a deployment is slow or fails — for example, you can see whether a pod is waiting for image pull or failing readiness probes (health check).

Access deployment logs from the app's Deployments tab by clicking Open Terminal on a deployment, or from the global Builds page.

Live App logs

The Logs from running apps are streamed to the app's Logs tab in the Project Canvas. Start here when troubleshooting.

1. Open the app in the Project Canvas.
2. Go to the Logs tab in the Project Canvas drawer.
3. If your app runs multiple replicas, use the pod dropdown to select which pod to tail.

QuickStack system logs (admin only)

Logs for the QuickStack system pod itself are available to administrators only, from Settings → Platform → Operations & Maintenance → Open QuickStack Logs. Non-admin users cannot stream the QuickStack system logs.

Interactive terminal

The Terminal opens a shell session directly inside a running container from your browser.

Opening a terminal session

1. Open the app in the Project Canvas and go to the Logs tab.
2. In the Logs card, click Terminal next to the pod selector.

3. Choose your shell:

   • Start sh — available on almost all Linux containers (including Alpine)
   • Start bash — richer experience; requires bash to be installed in the image

4. To end the session, click Disconnect Session or close the dialog.

Limitations

Related

• Health checks
• Updates & maintenance (cleanup old logs)