mirror of https://github.com/docker/docs.git
130 lines
6.9 KiB
Markdown
130 lines
6.9 KiB
Markdown
---
|
|
description: Frequently asked questions for all platforms
|
|
keywords: desktop, mac, windows, faqs
|
|
redirect_from:
|
|
- /mackit/faqs/
|
|
- /docker-for-mac/faqs/
|
|
- /docker-for-windows/faqs/
|
|
- /desktop/faqs/
|
|
title: General FAQs for Desktop
|
|
---
|
|
|
|
### What are the system requirements for Docker Desktop?
|
|
|
|
For information about Docker Desktop system requirements, see:
|
|
|
|
- [Mac system requirements](../install/mac-install.md#system-requirements)
|
|
- [Windows system requirements](../install/windows-install.md#system-requirements)
|
|
- [Linux system requirements](../install/linux-install.md#system-requirements)
|
|
|
|
### Where does Docker Desktop get installed on my machine?
|
|
|
|
By default, Docker Desktop is installed at the following location:
|
|
|
|
- On Mac: `/Applications/Docker.app`
|
|
- On Windows: `C:\Program Files\Docker\Docker`
|
|
- On Linux: `/opt/docker-desktop`
|
|
|
|
### Do I need to pay to use Docker Desktop?
|
|
|
|
Docker Desktop is free for small businesses (fewer than 250 employees AND less than $10 million in annual revenue), personal use, education, and non-commercial open-source projects. Otherwise, it requires a paid subscription for professional use. Paid subscriptions are also required for government entities. When downloading and installing Docker Desktop, you are asked to agree to the [Docker Subscription Service Agreement](https://www.docker.com/legal/docker-subscription-service-agreement){: target="_blank" rel="noopener" class="_"}.
|
|
|
|
Read the [Blog](https://www.docker.com/blog/updating-product-subscriptions/){: target="_blank" rel="noopener" class="_" id="dkr_docs_subscription_btl"} and [FAQs](https://www.docker.com/pricing/faq){: target="_blank" rel="noopener" class="_" id="dkr_docs_subscription_btl"} to learn more.
|
|
|
|
### Do I need to pay to create or share Docker Extensions?
|
|
|
|
No, the [Docker Extension SDK](https://www.npmjs.com/package/@docker/extension-api-client){:target="_blank" rel="noopener" class="_"} is licensed under the Apache 2.0 License and is free to use. Anyone can create new Docker Extensions and share them without constraints.
|
|
|
|
### Do I need to use a specific license when I create a Docker Extension?
|
|
|
|
No, there is no constraint on how each extension should be licensed, this is up to the extension authors to decide when creating a new extension.
|
|
|
|
### Can I use Docker Desktop offline?
|
|
|
|
Yes, you can use Docker Desktop offline. However, you
|
|
cannot access features that require an active internet
|
|
connection. Additionally, any functionality that requires you to sign won't work while using Docker Desktop offline or in air-gapped environments.
|
|
This includes:
|
|
|
|
- The resources in the [Learning Center](../use-desktop/index.md)
|
|
- Pulling or pushing an image to Docker Hub
|
|
- [Image Access Management](../../docker-hub/image-access-management.md)
|
|
- [Vulnerability scanning](../../docker-hub/vulnerability-scanning.md)
|
|
- Viewing remote images in the Docker Dashboard
|
|
- Setting up [Dev Environments](../dev-environments/index.md)
|
|
- Docker build when using [BuildKit](../../build/buildkit/index.md#getting-started).
|
|
You can work around this by disabling BuildKit. Run `DOCKER_BUILDKIT=0 docker build .` to disable BuildKit.
|
|
- Deploying an app to the cloud through Compose
|
|
[ACI](../../cloud/aci-integration.md) and [ECS](../../cloud/ecs-integration.md)
|
|
integrations
|
|
- [Kubernetes](../kubernetes.md) (Images are download when you enable Kubernetes for the first time)
|
|
- Check for updates
|
|
- [In-app diagnostics](../troubleshoot/overview.md#diagnose-from-the-app) (including the [Self-diagnose tool](../troubleshoot/overview.md#diagnose-from-the-app))
|
|
- Tip of the week
|
|
- Sending usage statistics
|
|
|
|
### Where can I find information about diagnosing and troubleshooting Docker Desktop issues?
|
|
|
|
You can find information about diagnosing and troubleshooting common issues in the [Troubleshooting topic](../troubleshoot/overview.md).
|
|
|
|
If you do not find a solution in troubleshooting, browse the Github repositories or create a new issue:
|
|
|
|
- [docker/for-mac](https://github.com/docker/for-mac/issues){: target="_blank" rel="noopener" class="_"}
|
|
- [docker/for-win](https://github.com/docker/for-win/issues){: target="_blank" rel="noopener" class="_"}
|
|
- [docker/for-linux](https://github.com/docker/for-linux/issues){: target="_blank" rel="noopener" class="_"}
|
|
|
|
### How do I connect to the remote Docker Engine API?
|
|
|
|
To connect to the remote Engine API, you might need to provide the location of the Engine API for Docker clients and development tools.
|
|
|
|
Mac and Windows WSL 2 users can connect to the Docker Engine through a Unix socket: `unix:///var/run/docker.sock`.
|
|
|
|
If you are working with applications like [Apache Maven](https://maven.apache.org/){: target="_blank" rel="noopener" class="_"}
|
|
that expect settings for `DOCKER_HOST` and `DOCKER_CERT_PATH` environment
|
|
variables, specify these to connect to Docker instances through Unix sockets.
|
|
|
|
For example:
|
|
|
|
```console
|
|
$ export DOCKER_HOST=unix:///var/run/docker.sock
|
|
```
|
|
|
|
Docker Desktop Windows users can connect to the Docker Engine through a **named pipe**: `npipe:////./pipe/docker_engine`, or **TCP socket** at this URL:
|
|
`tcp://localhost:2375`.
|
|
|
|
For details, see [Docker Engine API](../../engine/api/index.md).
|
|
|
|
### How do I connect from a container to a service on the host?
|
|
|
|
The host has a changing IP address, or none if you have no network access.
|
|
We recommend that you connect to the special DNS name `host.docker.internal`,
|
|
which resolves to the internal IP address used by the host.
|
|
|
|
For more information and examples, see [how to connect from a container to a service on the host](../networking.md#i-want-to-connect-from-a-container-to-a-service-on-the-host).
|
|
|
|
### Can I pass through a USB device to a container?
|
|
|
|
Unfortunately, it is not possible to pass through a USB device (or a
|
|
serial port) to a container as it requires support at the hypervisor level.
|
|
|
|
### Can I run Docker Desktop in nested virtualization scenarios?
|
|
|
|
In general, Docker recommends running Docker Desktop natively on either Mac, Linux, or Windows. However, Docker Desktop for Windows can run inside a virtual desktop provided the virtual desktop is properly configured. For more information, see [Run Docker Desktop in a VM or VDI environment](../vm-vdi.md)
|
|
|
|
### Docker Desktop's UI appears green, distorted, or has visual artifacts. How do I fix this?
|
|
|
|
Docker Desktop uses hardware-accelerated graphics by default, which may cause problems for some GPUs. In such cases,
|
|
Docker Desktop will launch successfully, but some screens may appear green, distorted,
|
|
or have some visual artifacts.
|
|
|
|
To work around this issue, disable hardware acceleration by creating a `"disableHardwareAcceleration": true` entry in Docker Desktop's `settings.json` file. You can find this file at:
|
|
|
|
- **Mac**: `~/Library/Group Containers/group.com.docker/settings.json`
|
|
- **Windows**: `C:\Users\[USERNAME]\AppData\Roaming\Docker\settings.json`
|
|
|
|
After updating the `settings.json` file, close and restart Docker Desktop to apply the changes.
|
|
|
|
### Can I run Docker Desktop on Virtualized hardware?
|
|
|
|
No, currently this is unsupported and against terms of use.
|