DocumentationProjectsProject Status

Project Status

Get detailed information about your current project’s status and latest deployment.

Command

rollout status

Options

  • -v, --verbose - Show detailed information including recent deployments table

Example with Verbose Output

rollout status --verbose

How It Works

The status command:

  1. Looks for a .rollout/config.json file in your current directory
  2. Fetches project details from the API
  3. Gets the latest deployment information
  4. Displays everything in a beautiful dashboard format

Example Output

Basic Status

$ rollout status
 
📊 Project Status
 
┌─────────────────────────────────────────────────────────┐
│ PROJECT INFORMATION                                     │
├─────────────────────────────────────────────────────────┤
│ Name:     ancient-bee-1234                              │
│ Slug:     ancient-bee-1234                              │
│ ID:       123                                           │
│ URL:      https://ancient-bee-1234.rollout.run         │
│ Status:   active                                        │
└─────────────────────────────────────────────────────────┘
 
┌─────────────────────────────────────────────────────────┐
│ LATEST DEPLOYMENT                                       │
├─────────────────────────────────────────────────────────┤
│ Status:   ✅ success                                    │
│ Version:  3                                             │
│ Files:    12                                            │
│ Size:     1.2 MB                                        │
│ Deployed: 1/15/2024, 2:30:15 PM                       │
│ URL:      https://ancient-bee-1234.rollout.run         │
└─────────────────────────────────────────────────────────┘
 
🚀 Quick Actions
 
• rollout deploy - Deploy current directory
• rollout history - View deployment history
• rollout status --verbose - Show detailed information

Verbose Status

$ rollout status --verbose
 
📊 Project Status
 
[Project Information Card - same as above]
 
[Latest Deployment Card - same as above]
 
📜 Recent Deployments
 
┌────────┬────────────┬────────────────────┬────────┬────────────┐
│ Version│ Status     │ Date               │ Files  │ Size       │
├────────┼────────────┼────────────────────┼────────┼────────────┤
│ 3      │ ✅ Success │ 1/15/2024 2:30:15  │ 12     │ 1.2 MB     │
│ 2      │ ✅ Success │ 1/15/2024 1:45:22  │ 10     │ 980 KB     │
│ 1      │ ✅ Success │ 1/15/2024 1:20:10  │ 8      │ 756 KB     │
└────────┴────────────┴────────────────────┴────────┴────────────┘
 
... and 2 more deployments
Run "rollout history" to see all deployments
 
🚀 Quick Actions
 
• rollout deploy - Deploy current directory
• rollout history - View deployment history
• rollout status --verbose - Show detailed information

Status Information

Project Information Card

  • Name: Project display name
  • Slug: URL-friendly identifier
  • ID: Internal project ID
  • URL: Live site URL
  • Status: Project status (active, suspended, deleted)

Latest Deployment Card

  • Status: Deployment status with icon (✅ success, ❌ failed, ⏳ pending)
  • Version: Deployment version number
  • Files: Number of files deployed
  • Size: Total deployment size
  • Deployed: When the deployment was completed
  • URL: Live deployment URL

Recent Deployments Table (Verbose)

Shows the last 5 deployments in a formatted table with:

  • Version number
  • Status with color coding
  • Deployment date and time
  • File count
  • Deployment size

Troubleshooting

No .rollout Directory

If you haven’t deployed from this directory:

📁 No .rollout directory found.
Deploy a project first to create project tracking.

No Project Configuration

If the config file is missing:

⚙️  No project configuration found.
Deploy a project first to create project tracking.

Project Not Found

If the project was deleted or you don’t have access:

❌ Project not found.
The project may have been deleted or you may not have access.

No Deployments

If the project exists but has no deployments:

┌─────────────────────────────────────────────────────────┐
│ NO DEPLOYMENTS                                          │
├─────────────────────────────────────────────────────────┤
│ No deployments found for this project.                 │
│ Run "rollout deploy" to create your first deployment.  │
└─────────────────────────────────────────────────────────┘

Not Logged In

If you’re not authenticated:

✗ Please login first: rollout login

Related Commands

  • rollout deploy - Create a new deployment
  • rollout history - View all deployment history
  • rollout list - List all your projects
List ProjectsDeployments