> ## Documentation Index
> Fetch the complete documentation index at: https://vastai-80aa3a82-ltxv2-serverless.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Instances

> Learn how to manage running instances - start, stop, destroy, monitor status, and handle common operational tasks.

<script
  type="application/ld+json"
  dangerouslySetInnerHTML={{
__html: JSON.stringify({
"@context": "https://schema.org",
"@type": "TechArticle",
"headline": "Managing Vast.ai Instances",
"description": "Complete guide to managing Vast.ai instances including starting, stopping, destroying, monitoring status, handling restarts, data management, connection methods, and troubleshooting instance states.",
"author": {
  "@type": "Organization",
  "name": "Vast.ai"
},
"articleSection": "Instances Documentation",
"keywords": ["instance management", "start", "stop", "destroy", "status monitoring", "troubleshooting", "vast.ai", "GPU instances"]
})
}}
/>

## Overview

The Instances page ([cloud.vast.ai/instances](https://cloud.vast.ai/instances)) is your central hub for managing rented instances. From here you can:

* View instance status and information
* Start, stop, and destroy instances
* Access connection details
* Monitor resource usage
* Transfer data between instances

## Instance Card Interface

<Frame caption="Instances Page">
  <img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/raWWQ-_K1M8Puobr/images/console-instance-guide.webp?fit=max&auto=format&n=raWWQ-_K1M8Puobr&q=85&s=61181662d998d4f15b5e6503c7b9bd0f" alt="" width="865" height="421" data-path="images/console-instance-guide.webp" />
</Frame>

Each instance card displays comprehensive information about your rental:

### Main Status Button

<Frame caption="Open button">
  <img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/raWWQ-_K1M8Puobr/images/console-instance-guide-2.webp?fit=max&auto=format&n=raWWQ-_K1M8Puobr&q=85&s=e8a8f835c8bdb7d35b1b0fbe4de86727" alt="" width="800" height="202" data-path="images/console-instance-guide-2.webp" />
</Frame>

The main button (left side of card) shows instance status and provides quick access:

**Status Indicators:**

* **Open**: Instance loaded, click to access via browser
* **Connect**: Instance loaded, click for SSH info
* **Inactive**: Stopped but data preserved (can restart if GPU available)
* **Offline**: Machine disconnected from Vast servers
* **Scheduling**: Attempting to restart (waiting for GPU availability)
* **Creating**: Vast initiating instance creation
* **Loading**: Downloading Docker image
* **Connecting**: Docker running but connection not verified

### Instance Information

<Frame caption="ID numbers">
  <img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/raWWQ-_K1M8Puobr/images/console-instance-guide-9.webp?fit=max&auto=format&n=raWWQ-_K1M8Puobr&q=85&s=206d82f432d5bedf2b1a38deffcb1f68" alt="" width="1137" height="265" data-path="images/console-instance-guide-9.webp" />
</Frame>

**ID Information:**

* Instance ID - Unique identifier for your instance
* Host/Datacenter ID - Provider identification
* Machine ID - Physical machine identifier

**Hardware Details:**

<img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/raWWQ-_K1M8Puobr/images/console-instance-guide-10.webp?fit=max&auto=format&n=raWWQ-_K1M8Puobr&q=85&s=024737530a17b309d6b8e51f7e4a4e4d" alt="" width="800" height="194" data-path="images/console-instance-guide-10.webp" />

* GPU model and count
* CPU and RAM allocation
* Storage capacity
* Network configuration

**Contract Info:**

<img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/raWWQ-_K1M8Puobr/images/console-instance-guide-12.webp?fit=max&auto=format&n=raWWQ-_K1M8Puobr&q=85&s=f5ef9a207d7456b9d583c57915b6e080" alt="" width="800" height="396" data-path="images/console-instance-guide-12.webp" />

* Instance age (time since creation)
* Expiry date (contract end time)
* Remaining duration

## Instance Operations

### Starting, Stopping, and Destroying

<img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/raWWQ-_K1M8Puobr/images/console-instance-guide-5.webp?fit=max&auto=format&n=raWWQ-_K1M8Puobr&q=85&s=9193668a80b27c8138d53f69a8275d9c" alt="" width="1280" height="307" data-path="images/console-instance-guide-5.webp" />

* **Stop Button** (square icon): Pauses instance, preserves data, continues storage charges
* **Destroy Button** (trash icon): Permanently deletes instance and all data
* **Restart Button** (play icon): Appears when stopped, attempts to reclaim GPU

<Warning>
  **Important:** Stopped instances continue incurring storage charges. Destroy instances when no longer needed to avoid ongoing costs.
</Warning>

### Restart Behavior

<Frame caption="Play button">
  <img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/raWWQ-_K1M8Puobr/images/console-instance-guide-6.webp?fit=max&auto=format&n=raWWQ-_K1M8Puobr&q=85&s=5b044a41d7b67254c76092360732372b" alt="" width="1280" height="306" data-path="images/console-instance-guide-6.webp" />
</Frame>

When restarting a stopped instance:

1. Instance enters `SCHEDULING` status
2. Waits for GPU availability
3. If stuck >30 seconds, GPU likely rented by another user
4. Cancel scheduling by clicking stop again
5. Consider creating new instance if GPU unavailable

### Additional Controls

<img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/raWWQ-_K1M8Puobr/images/console-instance-guide-13.webp?fit=max&auto=format&n=raWWQ-_K1M8Puobr&q=85&s=abf17867e78d1892268ef9a7c6b3d689" alt="" width="1280" height="306" data-path="images/console-instance-guide-13.webp" />

* **Label Instance** - Add custom name for identification
* **Reboot Instance** - Restart without data loss
* **View Logs** - Access Docker container logs

## Data Management

<Frame caption="Data movement">
  <img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/raWWQ-_K1M8Puobr/images/console-instance-guide-7.webp?fit=max&auto=format&n=raWWQ-_K1M8Puobr&q=85&s=d73dae2661b57b559377f945370b9801" alt="" width="1280" height="330" data-path="images/console-instance-guide-7.webp" />
</Frame>

* **Copy Data** - Transfer between your instances (see [Data Movement](/documentation/instances/storage/data-movement))
* **Cloud Sync** - Sync with cloud providers (see [Cloud Sync](/documentation/instances/storage/cloud-sync))

<Note>
  Use Cloud Sync only on trusted datacenters (indicated by **Secure** icon).
</Note>

## Connection Quick Reference

For detailed connection instructions, see [Connect to Instances](/documentation/instances/connect/overview):

* **SSH button** - Shows SSH command
* **Open button** - Launches web UI
* **IP/Ports button** - Network information

## Troubleshooting Instance States

### Instance Stuck on "Loading"

* Normal for 30 seconds with cached images
* Can take hours with slow internet/large images
* Not charged during loading
* Try machines with faster internet

### Instance Stuck on "Scheduling"

When stopped instances try to restart:

* GPU may be reassigned to other users
* High-priority jobs block restart
* May wait indefinitely for GPU availability
* Consider copying data to new instance

### Instance Stuck on "Connecting"

* Port configuration may be broken
* Report the machine
* Try different machine

### Machine Shows "Offline"

* Lost connection to Vast servers
* Often internet/power issues
* Host notified automatically
* May be maintenance or unforeseen problems

## Important Considerations

### Data Persistence

* **Stopped instances**: Data preserved, storage charges continue
* **Destroyed instances**: All data permanently deleted
* **Before destroying**: Copy important data or sync to cloud

### Contract Expiration

<Warning>
  Expired instances may be deleted 48 hours after expiration. Expired instances cannot restart. Retrieve your data promptly.
</Warning>

### Security

* Hosts can technically access files on their machines
* For sensitive data, use verified datacenters
* Implement encryption for critical data

### IP Addresses

Some instances have dynamic IPs that may change. Check IP type via the IP button on instance card. For static IPs, filter by "Static IP Address" when searching.

## Common Questions

### Can I run Docker inside my instance?

No, instances are already Docker containers. Docker-in-Docker is not supported.

### Do I pay for "Loading" instances?

No, you're not charged while instances show "Loading" status.

### Can I view past instances?

No, destroyed instances cannot be viewed. Recent template history is preserved for configuration reference.

### Why is my machine location showing only ", US"?

This means geolocation couldn't determine the state. It's not an indication of reliability.

### Can I run VMs or bare metal?

Currently only Docker containers are supported. VM and bare-metal options planned for future.

## Next Steps

<CardGroup cols={3}>
  <Card title="Data Movement" href="/documentation/instances/storage/data-movement" icon="arrows">
    Transfer files to and from your instances
  </Card>

  <Card title="Reserved Instances" href="/documentation/instances/choosing/reserved-instances" icon="calendar">
    Save up to 50% with long-term commitments
  </Card>

  <Card title="Instance Portal" href="/documentation/instances/instance-portal" icon="browser">
    Access web services running in your instances
  </Card>
</CardGroup>
