List Projects

View all your Rollout projects and their current status.

Command

rollout list

Basic Usage

rollout list

Options

-v, --verbose - Show detailed information including creation date and description

Example with Verbose Output

rollout list --verbose

Example Output

Basic List

$ rollout list
Fetching projects...
 
Found 3 project(s):
 
1. ancient-bee-1234
   URL: https://ancient-bee-1234.rollout.run
   Status: active
 
2. my-awesome-site
   URL: https://my-awesome-site.rollout.run
   Status: active
 
3. test-project
   URL: https://test-project.rollout.run
   Status: active

Verbose List

$ rollout list --verbose
Fetching projects...
 
Found 3 project(s):
 
1. ancient-bee-1234
   URL: https://ancient-bee-1234.rollout.run
   Status: active
   Created: 1/15/2024
   Description: Deployed from /path/to/my/site
 
2. my-awesome-site
   URL: https://my-awesome-site.rollout.run
   Status: active
   Created: 1/14/2024
   Description: My awesome static site
 
3. test-project
   URL: https://test-project.rollout.run
   Status: active
   Created: 1/13/2024

Project Information

Each project shows:

Name: The project name (Heroku-style or custom)
URL: The live URL where your site is hosted
Status: Current project status (active, suspended, deleted)

With --verbose flag, you also get:

Created: When the project was created
Description: Project description (if set)

Troubleshooting

Not Logged In

If you’re not authenticated:

✗ Please login first: rollout login

No Projects Found

If you haven’t created any projects yet:

No projects found. Create one with: rollout deploy

Failed to Fetch Projects

If there’s an API error:

✗ Failed to fetch projects: [error message]

rollout deploy - Create a new project by deploying
rollout status - Get detailed status for current project
rollout history - View deployment history for current project

Deploy Site Project Status