Skip to content

Commit 6a9bf3c

Browse files
[Docs] Added No fleets cause for No offers in the Troubleshooting guide
1 parent 31faaf4 commit 6a9bf3c

File tree

1 file changed

+19
-16
lines changed

1 file changed

+19
-16
lines changed

docs/docs/guides/troubleshooting.md

Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -28,25 +28,28 @@ and [this](https://github.com/dstackai/dstack/issues/1551).
2828

2929
## Typical issues
3030

31-
### No instance offers { #no-offers }
31+
### No offers { #no-offers }
3232
[//]: # (NOTE: This section is referenced in the CLI. Do not change its URL.)
3333

3434
If you run `dstack apply` and don't see any instance offers, it means that
3535
`dstack` could not find instances that match the requirements in your configuration.
3636
Below are some of the reasons why this might happen.
3737

38-
#### Cause 1: No capacity providers
38+
> Feel free to use `dstack offer` to view available offers.
3939
40-
Before you can run any workloads, you need to configure a [backend](../concepts/backends.md),
41-
create an [SSH fleet](../concepts/fleets.md#ssh-fleets), or sign up for
42-
[dstack Sky](https://sky.dstack.ai).
43-
If you have configured a backend and still can't use it, check the output of `dstack server`
44-
for backend configuration errors.
40+
#### Cause 1: No fleets
4541

46-
> **Tip**: You can find a list of successfully configured backends
47-
> on the [project settings page](../concepts/projects.md#backends) in the UI.
42+
Make sure you've created a [fleet](../concepts/fleets.md) before submitting any runs.
4843

49-
#### Cause 2: Requirements mismatch
44+
#### Cause 2: No backends
45+
46+
If you are not using [SSH fleets](../concepts/fleets.md#ssh-fleets), make sure you have configured at least one [backends](../concepts/backends.md).
47+
48+
If you have configured a backend but still cannot use it, check the output of `dstack server` for backend configuration errors.
49+
50+
> You can find a list of successfully configured backends on the [project settings page](../concepts/projects.md#backends) in the UI.
51+
52+
#### Cause 3: Requirements mismatch
5053

5154
When you apply a configuration, `dstack` tries to find instances that match the
5255
[`resources`](../reference/dstack.yml/task.md#resources),
@@ -63,7 +66,7 @@ Make sure your configuration doesn't set any conflicting requirements, such as
6366
`regions` that don't exist in the specified `backends`, or `instance_types` that
6467
don't match the specified `resources`.
6568

66-
#### Cause 3: Too specific resources
69+
#### Cause 4: Too specific resources
6770

6871
If you set a resource requirement to an exact value, `dstack` will only select instances
6972
that have exactly that amount of resources. For example, `cpu: 5` and `memory: 10GB` will only
@@ -73,14 +76,14 @@ Typically, you will want to set resource ranges to match more instances.
7376
For example, `cpu: 4..8` and `memory: 10GB..` will match instances with 4 to 8 CPUs
7477
and at least 10GB of memory.
7578

76-
#### Cause 4: Default resources
79+
#### Cause 5: Default resources
7780

7881
By default, `dstack` uses these resource requirements:
7982
`cpu: 2..`, `memory: 8GB..`, `disk: 100GB..`.
8083
If you want to use smaller instances, override the `cpu`, `memory`, or `disk`
8184
properties in your configuration.
8285

83-
#### Cause 5: GPU requirements
86+
#### Cause 6: GPU requirements
8487

8588
By default, `dstack` only selects instances with no GPUs or a single NVIDIA GPU.
8689
If you want to use non-NVIDIA GPUs or multi-GPU instances, set the `gpu` property
@@ -91,13 +94,13 @@ Examples: `gpu: amd` (one AMD GPU), `gpu: A10:4..8` (4 to 8 A10 GPUs),
9194

9295
> If you don't specify the number of GPUs, `dstack` will only select single-GPU instances.
9396
94-
#### Cause 6: Network volumes
97+
#### Cause 7: Network volumes
9598

9699
If your run configuration uses [network volumes](../concepts/volumes.md#network-volumes),
97100
`dstack` will only select instances from the same backend and region as the volumes.
98101
For AWS, the availability zone of the volume and the instance should also match.
99102

100-
#### Cause 7: Feature support
103+
#### Cause 8: Feature support
101104

102105
Some `dstack` features are not supported by all backends. If your configuration uses
103106
one of these features, `dstack` will only select offers from the backends that support it.
@@ -113,7 +116,7 @@ one of these features, `dstack` will only select offers from the backends that s
113116
- [Reservations](../reference/dstack.yml/fleet.md#reservation)
114117
are only supported by the `aws` and `gcp` backends.
115118

116-
#### Cause 8: dstack Sky balance
119+
#### Cause 9: dstack Sky balance
117120

118121
If you are using
119122
[dstack Sky](https://sky.dstack.ai),

0 commit comments

Comments
 (0)