Skip to content

Commit

Permalink
docs: Added guide on Docker alternatives (#5053)
Browse files Browse the repository at this point in the history
Signed-off-by: Vikram Vaswani <vikram@dagger.io>
  • Loading branch information
vikram-dagger committed May 4, 2023
1 parent 08dcc15 commit 08cbce9
Showing 1 changed file with 52 additions and 0 deletions.
52 changes: 52 additions & 0 deletions docs/current/guides/541047-alternative-runtimes.md
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.

0 comments on commit 08cbce9

Please sign in to comment.