> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pxxl.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Projects: Deployments, Logs, and Scaling on Pxxl

> Use the Projects page to inspect deployments, live logs, environment variables, domains, monitoring, scaling, and project settings.

The Projects page is the central view for every application running in your Pxxl workspace. Open **Dashboard > Projects** to see a card for each project, quickly understand its current state, and dive into the full suite of project management tabs. Whether you need to investigate a failed build, rotate an environment variable, or dial up memory for a high-traffic service, every control lives inside the project workspace.

## Project Cards

Each card in the project list gives you a compact snapshot of the application at a glance. Select a card to open its full project workspace.

| Area | Meaning |
| - | - |
| **Screenshot** | A current preview image rendered from the live application. |
| **Project name** | The internal Pxxl name assigned when the project was created. |
| **Framework and repository** | The detected technology stack and the linked GitHub source repository. |
| **Domain count** | The number of domains currently attached to the project. |
| **Primary domain** | The main public URL shown on the card for quick access. |
| **Latest commit / status text** | The most recent deployment context, including commit message or build state. |
| **Last activity** | How recently any deployment or configuration change occurred. |

## Project Tabs

Once you open a project, a set of tabs gives you focused access to every aspect of the application's infrastructure, runtime, and configuration.

| Tab | Use it for |
| - | - |
| **Overview** | An architecture canvas showing connected services, sticky notes, attached domains, and overall project context at a glance. |
| **Deployments** | The complete build and deploy history for this project, including status, commit metadata, timestamps, and previous deploy attempts. |
| **Live Logs** | Real-time runtime logs from the running service container, your first stop for startup errors, failed requests, and framework output. |
| **Environment Variables** | Global workspace variables and project-scoped secrets such as API keys, database URLs, and feature flags. See [Secrets](https://docs.pxxl.app/projects/secrets.md). |
| **Issues** | Linked issues and handoff notes that connect infrastructure problems to product work. |
| **Domains** | Hostnames currently routed to this project and their connection state. For deeper DNS and SSL controls, use [Domains](https://docs.pxxl.app/domains/overview.md). |
| **Web Analytics** | Visitor, request, bandwidth, latency, route, and edge activity. See [Web Analytics](https://docs.pxxl.app/projects/web-analytics.md). |
| **Monitoring** | Runtime health, CPU, memory, and resource footprint. See [Monitoring](https://docs.pxxl.app/projects/monitoring.md). |
| **Terminal** | A shell session inside the active runtime. See [Terminal](https://docs.pxxl.app/projects/terminal.md). |
| **Compute & Scaling** | CPU, memory, replicas, persistent volumes, and autoscaling. See [Compute](https://docs.pxxl.app/projects/compute.md). |
| **Password Protection** | Put a shared visitor password in front of preview routes or the full project. See [Password Protection](https://docs.pxxl.app/projects/password-protection.md). |
| **Log Drains** | Send project logs to an external destination for retention or analysis. See [Log Drains](https://docs.pxxl.app/storage/log-drains.md). |
| **Settings** | Repository connection details, build behavior, GitHub automation triggers, deployment protection rules, and destructive project actions. |

## Deployments

Use the **Deployments** tab to review build history, inspect individual deploy attempts, check commit metadata, and confirm which version of the application is currently serving traffic. Open this tab first whenever the app is not serving the expected version or a deployment appears stalled.

## Live Logs

Use **Live Logs** to inspect real-time runtime output from the running service. This is where you find application startup errors, unhandled exceptions, failed HTTP requests, and framework-level diagnostics.

> [!TIP]
>
> Open **Live Logs** immediately after a new deploy completes. If the container fails to start, the log will show the exact error, such as a missing environment variable, a wrong port binding, or a failed database connection, within seconds.

## Secrets

Use **Secrets** for all credentials, database URLs, and runtime configuration values the application needs. The tab separates global workspace variables from project-scoped variables. Read the full [Secrets guide](https://docs.pxxl.app/projects/secrets.md) before rotating a production value.

## Issues

Use **Issues** to track project-level problems and leave handoff notes for teammates. This tab is useful for connecting infrastructure incidents to product backlogs and ensuring context is not lost during incidents or handoffs.

## Domains

The **Domains** tab shows which hostnames are currently routed to this project and their proxy connection state. Use this tab for application-level routing decisions. For DNS record management, nameserver configuration, SSL certificate status, and proxy security controls, open [Domains](https://docs.pxxl.app/domains/overview.md) and select the domain directly.

## Web Analytics

Use **Web Analytics** to review visitors, requests, bandwidth, latency, routes, and recent edge activity. See the [Web Analytics guide](https://docs.pxxl.app/projects/web-analytics.md) for the meaning of each metric.

## Monitoring

Use **Monitoring** to review CPU, memory, sandbox overhead, and runtime footprint. Open the [Monitoring guide](https://docs.pxxl.app/projects/monitoring.md) when you need to interpret a resource spike.

## Terminal

Use **Terminal** for short-lived checks inside the active runtime. Read the [Terminal guide](https://docs.pxxl.app/projects/terminal.md) before changing files or processes from a running container.

## Compute & Scaling

Use **Compute & Scaling** to change CPU, memory, replicas, persistent volumes, or autoscaling. See the [Compute guide](https://docs.pxxl.app/projects/compute.md) before changing resources for a production service.

## Settings

Use **Settings** for repository connection details, build behavior overrides, GitHub automation configuration, deployment protection rules, and destructive project actions such as deleting the project or transferring ownership. Project-level access and log export controls also live here:

* [Password Protection](https://docs.pxxl.app/projects/password-protection.md) puts a shared visitor password in front of preview routes or the full project.
* [Log Drains](https://docs.pxxl.app/storage/log-drains.md) sends project output to an external destination such as S3-compatible storage.

Read the current value of any setting before changing it, and review the danger zone before taking irreversible actions.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.