@@ -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
3434If 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.
3636Below 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
5154When 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
6467don't match the specified ` resources ` .
6568
66- #### Cause 3 : Too specific resources
69+ #### Cause 4 : Too specific resources
6770
6871If you set a resource requirement to an exact value, ` dstack ` will only select instances
6972that 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.
7376For example, ` cpu: 4..8 ` and ` memory: 10GB.. ` will match instances with 4 to 8 CPUs
7477and at least 10GB of memory.
7578
76- #### Cause 4 : Default resources
79+ #### Cause 5 : Default resources
7780
7881By default, ` dstack ` uses these resource requirements:
7982` cpu: 2.. ` , ` memory: 8GB.. ` , ` disk: 100GB.. ` .
8083If you want to use smaller instances, override the ` cpu ` , ` memory ` , or ` disk `
8184properties in your configuration.
8285
83- #### Cause 5 : GPU requirements
86+ #### Cause 6 : GPU requirements
8487
8588By default, ` dstack ` only selects instances with no GPUs or a single NVIDIA GPU.
8689If 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
9699If 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.
98101For 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
102105Some ` dstack ` features are not supported by all backends. If your configuration uses
103106one 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
118121If you are using
119122[ dstack Sky] ( https://sky.dstack.ai ) ,
0 commit comments