DocumentationDeploymentsHistory

Deployment History

View the deployment history for your current project in a clean table format.

Command

rollout history

Options

  • -l, --limit <number> - Limit number of deployments to show (default: 10)

Example with Custom Limit

rollout history --limit 20

How It Works

The history command:

  1. Looks for a .rollout/config.json file in your current directory
  2. Fetches deployment history from the API
  3. Displays deployments in a formatted table

Example Output

$ rollout history
 
📜 Deployment History (10 deployments)
 
┌────────┬────────────┬────────────────────┬────────┬────────────┬────────────────────────────────────────┐
│ Version│ Status     │ Date               │ Files  │ Size       │ URL                                     │
├────────┼────────────┼────────────────────┼────────┼────────────┼────────────────────────────────────────┤
│ 10     │ ✓ Success │ 1/15/2024 2:30:15 │ 12     │ 1.2 MB     │ https://ancient-bee-1234.rollout.run   │
│ 9      │ ✓ Success │ 1/15/2024 1:45:22 │ 10     │ 980 KB     │ https://ancient-bee-1234.rollout.run   │
│ 8      │ ✓ Success │ 1/15/2024 1:20:10 │ 8      │ 756 KB     │ https://ancient-bee-1234.rollout.run   │
│ 7      │ ✗ Failed  │ 1/15/2024 1:15:05 │ 0      │ N/A        │ N/A                                     │
│ 6      │ ✓ Success │ 1/15/2024 1:10:00 │ 15     │ 1.5 MB     │ https://ancient-bee-1234.rollout.run   │
│ 5      │ ✓ Success │ 1/14/2024 5:30:15 │ 9      │ 850 KB     │ https://ancient-bee-1234.rollout.run   │
│ 4      │ ✓ Success │ 1/14/2024 4:20:10 │ 11     │ 1.1 MB     │ https://ancient-bee-1234.rollout.run   │
│ 3      │ ✓ Success │ 1/14/2024 3:15:05 │ 7      │ 650 KB     │ https://ancient-bee-1234.rollout.run   │
│ 2      │ ✓ Success │ 1/14/2024 2:10:00 │ 6      │ 580 KB     │ https://ancient-bee-1234.rollout.run   │
│ 1      │ ✓ Success │ 1/14/2024 1:05:00 │ 5      │ 450 KB     │ https://ancient-bee-1234.rollout.run   │
└────────┴────────────┴────────────────────┴────────┴────────────┴────────────────────────────────────────┘
 
Showing 10 most recent deployments
Use --limit 20 to see more deployments

Table Columns

  • Version: Deployment version number (ascending)
  • Status: Deployment status with color coding:
    • ✓ Success (green) - Deployment completed successfully
    • ✗ Failed (red) - Deployment failed
    • ⏳ Pending (yellow) - Deployment in progress
  • Date: When the deployment was completed (or attempted)
  • Files: Number of files in the deployment
  • Size: Total size of the deployment (formatted)
  • URL: Live deployment URL (truncated if too long)

Status Indicators

Success

  • Green checkmark (✓)
  • Shows file count and size
  • Displays live URL

Failed

  • Red X (✗)
  • Shows 0 files and N/A size
  • No URL displayed

Pending

  • Yellow hourglass (⏳)
  • May show partial information
  • URL may not be available yet

Troubleshooting

No Project Found

If you haven’t deployed from this directory:

No project found for current directory.
Deploy a project first to create project tracking.

No Deployments Found

If the project exists but has no deployments:

No deployments found for this project.

Not Logged In

If you’re not authenticated:

✗ Please login first: rollout login

API Error

If there’s a problem fetching data:

✗ Failed to get deployment history: [error message]

Tips

View More Deployments

To see more deployments, increase the limit:

rollout history --limit 50

Check Current Status

For the latest deployment status:

rollout status

Deploy New Version

To create a new deployment:

rollout deploy

Related Commands

  • rollout status - Get current project status
  • rollout deploy - Create a new deployment
  • rollout list - List all your projects
DeploymentsManage