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

# Web UI Walkthrough

> Explore the Pullbase web interface for day-to-day operations.

The Pullbase web UI offers a fast way to review environments, manage users, and issue agent tokens. Use it alongside the CLI and API for visibility and manual operations.

## Sign-in

* Visit your Pullbase URL (e.g., `http://localhost:8080` for development or `https://pullbase.example.com` for production).
* Enter the admin or user credentials created during bootstrapping.
* The session cookie stores a JWT; sign out via the avatar menu when finished.

<Card title="Pullbase Login" img="https://mintcdn.com/pullbase/La3vyrYKs2uDAFQQ/images/pullbase-login.png?fit=max&auto=format&n=La3vyrYKs2uDAFQQ&q=85&s=f57d7ce889d3c96dafd125a5ccbf2174" width="2940" height="1814" data-path="images/pullbase-login.png" />

## Dashboard

The landing page summarizes key metrics:

* Environment count and drift status
* Recent activity feed (status reports, token creation, rollbacks)
* Quick links to environments and servers

<Card title="Pullbase Dashboard" img="https://mintcdn.com/pullbase/La3vyrYKs2uDAFQQ/images/pullbase-dashboard.png?fit=max&auto=format&n=La3vyrYKs2uDAFQQ&q=85&s=8c623d1a8fb15b3d8b00429755d01827" width="2940" height="2810" data-path="images/pullbase-dashboard.png" />

## Environments view

Navigate to **Environments** to manage Git metadata.

* Search or filter environments by name
* Inspect repository URL, branch, deploy path, and target commit hash
* Toggle auto-reconcile, edit metadata, or delete the environment
* Initiate rollbacks and view rollback history

<Card title="Pullbase Environment View" img="https://mintcdn.com/pullbase/La3vyrYKs2uDAFQQ/images/pullbase-environment-view.png?fit=max&auto=format&n=La3vyrYKs2uDAFQQ&q=85&s=eaa0cc3d1fcdee9c759073e884829432" width="2942" height="1814" data-path="images/pullbase-environment-view.png" />

## Servers View

Navigate to **Servers** to see all Pullbase managed servers.

* Search or filter servers by name
* Inspect environment association and status
* View last applied commit and drift status

<Card title="Pullbase Servers View" img="https://mintcdn.com/pullbase/La3vyrYKs2uDAFQQ/images/pullbase-servers-view.png?fit=max&auto=format&n=La3vyrYKs2uDAFQQ&q=85&s=50bc6f3f8c5c403af3b4e91dd79b8950" width="2942" height="1816" data-path="images/pullbase-servers-view.png" />

## Server detail view

From an environment page, choose a server to see its status timeline.

* View last applied commit, drift flag, and timestamps
* Monitor reconciliation history and error messages
* Issue or revoke agent tokens directly from the server page

<Card title="Pullbase Server Detail View" img="https://mintcdn.com/pullbase/La3vyrYKs2uDAFQQ/images/pullbase-server-detail-page.png?fit=max&auto=format&n=La3vyrYKs2uDAFQQ&q=85&s=b276d6c7d6c52bb265eb11b81fdbaacf" width="2942" height="2480" data-path="images/pullbase-server-detail-page.png" />

## Token management

* Use **Add Token** to generate a new agent token
* Tokens include description and optional expiration date
* Copy the token immediately; Pullbase never shows the secret again (tokens are hashed at rest)

<Warning>
  Rotate tokens by creating a new one, updating the agent, and then revoking the old token. Avoid deleting active tokens before the agent refreshes.
</Warning>

## User management

Accessible via **Settings → Users** (admins only).

* Create, list, or delete users
* Set roles (`admin`, `user`, `viewer`)
* Deletion requires typing the username to confirm; Pullbase blocks deletion of the last active admin or your own account

<Card title="Pullbase User Management View" img="https://mintcdn.com/pullbase/La3vyrYKs2uDAFQQ/images/pullbase-users-view.png?fit=max&auto=format&n=La3vyrYKs2uDAFQQ&q=85&s=0eb77e4f2f2ed40d53034ed4448df994" width="2942" height="2796" data-path="images/pullbase-users-view.png" />
