Skip to content

Commit 10d48f9

Browse files
committed
Add guide for developing with Podman instead of Docker
1 parent 1aa7b31 commit 10d48f9

File tree

1 file changed

+46
-0
lines changed

1 file changed

+46
-0
lines changed

docs/howto/use_podman.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# How to Develop Using Podman Instead of Docker
2+
3+
Podman is a container engine that is compatible with Docker but does not require a daemon and can run containers rootless. If you want to use Podman for development instead of Docker, follow these steps:
4+
5+
## 1. Install Podman
6+
7+
Refer to the [official Podman installation guide](https://podman.io/getting-started/installation) for your operating system.
8+
9+
## 2. Configure Docker Compatibility
10+
11+
Podman provides a Docker-compatible CLI. You can setup Podman so it runs whenever the docker commands are run, [follow the migration guide](https://podman-desktop.io/docs/migrating-from-docker/managing-docker-compatibility)
12+
13+
## 3. Run Docker Commands with Podman
14+
15+
Most Docker commands work with Podman. For example:
16+
17+
```sh
18+
podman build -t my-image .
19+
podman run -it my-image
20+
podman ps
21+
```
22+
23+
## 4. Use Podman Compose
24+
25+
If your project uses `docker-compose`, install [podman-compose](https://github.com/containers/podman-compose):
26+
27+
```sh
28+
pip install podman-compose
29+
```
30+
31+
Then use:
32+
33+
```sh
34+
podman-compose up
35+
```
36+
37+
## 5. Troubleshooting and Compatibility
38+
39+
- Podman is mostly compatible with Docker CLI and images.
40+
- Some advanced Docker features may require adjustments.
41+
- For more details, see the [Podman documentation](https://docs.podman.io/).
42+
43+
## 6. Additional Resources
44+
45+
- [Podman Official Documentation](https://docs.podman.io/)
46+
- [Podman vs Docker Comparison](https://podman.io/getting-started/)

0 commit comments

Comments
 (0)