-
Notifications
You must be signed in to change notification settings - Fork 563
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: Added guide on Docker alternatives (#5053)
Signed-off-by: Vikram Vaswani <vikram@dagger.io>
- Loading branch information
1 parent
08dcc15
commit 08cbce9
Showing
1 changed file
with
52 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,52 @@ | ||
--- | ||
slug: /541047/alternative-runtimes | ||
displayed_sidebar: 'current' | ||
category: "guides" | ||
tags: ["podman"] | ||
authors: ["Vikram Vaswani"] | ||
date: "2023-04-28" | ||
--- | ||
|
||
# Use Dagger with Alternative OCI Runtimes | ||
|
||
## Introduction | ||
|
||
This guide explains how to use Dagger with various OCI-compatible Docker alternatives. | ||
|
||
## Podman | ||
|
||
### Requirements | ||
|
||
This guide assumes that you have Podman installed and running on the host system. If not, [install Podman](https://podman.io/getting-started/installation). | ||
|
||
### Configuration | ||
|
||
By default, Dagger tries to invoke the `docker` executable. To use Podman instead, create a symbolic link to the Podman executable in your system path and name it `docker`: | ||
|
||
```shell | ||
sudo ln -s $(which podman) /usr/local/bin/docker | ||
``` | ||
|
||
:::note | ||
RHEL 8.x users may need to additionally execute `modprobe iptable_nat`. | ||
::: | ||
|
||
## Containerd (nerdctl) | ||
|
||
### Requirements | ||
|
||
This guide assumes that you have `nerdctl` installed and running on the host system in rootless mode. If not, [install the full release of `nerdctl`](https://github.com/containerd/nerdctl/releases) and [configure rootless mode](https://github.com/containerd/nerdctl/blob/main/docs/rootless.md). | ||
|
||
### Configuration | ||
|
||
By default, Dagger tries to invoke the `docker` executable. To use `nerdctl` instead, create a symbolic link to `nerdctl` in your system path and name it `docker`: | ||
|
||
```shell | ||
sudo ln -s $(which nerdctl) /usr/local/bin/docker | ||
``` | ||
|
||
## Conclusion | ||
|
||
This guide explained how to use Dagger with various OCI-compatible Docker alternatives, such as Podman and `nerdctl`. | ||
|
||
Use the [API Key Concepts](../api/975146-concepts.mdx) page and the [Go](https://pkg.go.dev/dagger.io/dagger), [Node.js](../sdk/nodejs/reference/modules.md) and [Python](https://dagger-io.readthedocs.org/) SDK References to learn more about Dagger. |