Skip to content

Commit 821d10a

Browse files
Added stop pod network volume info tip (#290)
Co-authored-by: Mo King <[email protected]>
1 parent 08343b5 commit 821d10a

File tree

1 file changed

+17
-9
lines changed

1 file changed

+17
-9
lines changed

pods/manage-pods.mdx

Lines changed: 17 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ runpodctl config --apiKey [RUNPOD_API_KEY]
1717

1818
<Tabs>
1919
<Tab title="Web">
20-
To create a Pod using the web interface:
20+
To create a Pod using the Runpod console:
2121

2222
1. Open the [Pods page](https://www.runpod.io/console/pods) in the Runpod console and click the **Deploy** button.
2323
2. (Optional) Specify a [network volume](/pods/storage/create-network-volumes) if you need to share data between multiple Pods, or to save data for later use.
@@ -70,19 +70,22 @@ With custom templates, you can:
7070

7171
## Stop a Pod
7272

73-
<Warning>
74-
75-
When a Pod is stopped, data in the container volume is cleared, but data in the `/workspace` directory is preserved. To learn more, see [Storage options](/pods/storage/types).
73+
<Tip>
74+
If your Pod has a [network volume](/pods/storage/create-network-volumes) attached, it cannot be stopped, only terminated. When you terminate the Pod, data in the `/workspace` directory will be preserved in the network volume, and you can regain access by deploying a new Pod with the same network volume attached.
75+
</Tip>
7676

77-
After a Pod is stopped, you will still be charged for its [disk volume storage](/pods/storage/types#disk-volume). If you don't need to retain your Pod environment, you should terminate it completely.
77+
When a Pod is stopped, data in the container volume is cleared, but data in the `/workspace` directory is preserved. To learn more about how Pod storage works, see [Storage overview](/pods/storage/types).
7878

79-
By stopping a Pod you are releasing the GPU on the machine, and you may be reallocated 0 GPUs when you start the Pod again. For more info, see the [FAQ](/references/faq#why-do-i-have-zero-gpus-assigned-to-my-pod%3F).
79+
By stopping a Pod you are effectively releasing the GPU on the machine, and you may be reallocated 0 GPUs when you start the Pod again. For more info, see the [FAQ](/references/faq#why-do-i-have-zero-gpus-assigned-to-my-pod%3F).
8080

81+
<Warning>
82+
After a Pod is stopped, you will still be charged for its [disk volume](/pods/storage/types#disk-volume) storage. If you don't need to retain your Pod environment, you should terminate it completely.
8183
</Warning>
8284

83-
8485
<Tabs>
8586
<Tab title="Web">
87+
To stop a Pod:
88+
8689
1. Open the [Pods page](https://www.runpod.io/console/pods).
8790
2. Find the Pod you want to stop and expand it.
8891
3. Click the **Stop button** (square icon).
@@ -101,9 +104,10 @@ runpodctl stop pod $RUNPOD_POD_ID
101104

102105
</Tabs>
103106

107+
104108
### Stop a Pod after a period of time
105109

106-
You can also stop a Pod after a specified period of time. The examples below show how to use the CLI and the [web terminal](/pods/connect-to-a-pod#web-terminal) to schedule a Pod to stop after 2 hours of runtime.
110+
You can also stop a Pod after a specified period of time. The examples below show how to use the CLI or [web terminal](/pods/connect-to-a-pod#web-terminal) to schedule a Pod to stop after 2 hours of runtime.
107111

108112
<Tabs>
109113
<Tab title="Command line">
@@ -136,6 +140,8 @@ Pods start as soon as they are created, but you can resume a Pod that has been s
136140

137141
<Tabs>
138142
<Tab title="Web">
143+
To start a Pod:
144+
139145
1. Open the [Pods page](https://www.runpod.io/console/pods).
140146
2. Find the Pod you want to start and expand it.
141147
3. Click the **Start** button (play icon).
@@ -157,12 +163,14 @@ runpodctl start pod $RUNPOD_POD_ID
157163

158164
<Warning>
159165

160-
Terminating a Pod permanently deletes all data outside of a [network volume](/pods/storage/create-network-volumes). Be sure to export or download any data that you'll need to access again.
166+
Terminating a Pod permanently deletes all associated data that isn't stored in a [network volume](/pods/storage/create-network-volumes). Be sure to export or download any data that you'll need to access again.
161167

162168
</Warning>
163169

164170
<Tabs>
165171
<Tab title="Web">
172+
To terminate a Pod:
173+
166174
1. Open the [Pods page](https://www.runpod.io/console/pods).
167175
2. Find the Pod you want to terminate and expand it.
168176
3. [Stop the Pod](#stop-a-pod) if it's running.

0 commit comments

Comments
 (0)