If you develop on a Mac and reach for docker compose to spin up a multi-service
stack, you might like opossum — a small,
Docker Compose–like orchestrator for Apple's container
runtime on macOS 26.
The pitch is simple: point it at a docker-compose.yml you already have and run
opossum up. The commands and mental model are the same ones you already know —
up, ps, logs, down — but everything runs on Apple's native container
runtime (a lightweight VM per container) instead of Docker Desktop.
Let me show you.
Install
opossum ships as a Homebrew formula:
brew install suruseas/opossum/opossum
Two one-time steps (Apple container prerequisites):
container system start # start the runtime
sudo container system dns create opossum # register a local DNS domain so
# services can find each other by name
That's it. (Requires macOS 26 on Apple silicon, since the runtime's
container-to-container networking relies on macOS 26 features.)
A familiar compose file
Nothing new here — just a plain compose file. Name it the modern compose.yaml
or the classic docker-compose.yml; opossum auto-discovers compose.yaml,
compose.yml, docker-compose.yaml, and docker-compose.yml, the same
precedence docker compose uses:
services:
web:
image: nginx:alpine
ports:
- "8080:80"
depends_on:
- redis
redis:
image: redis:7
opossum up
$ opossum up
Creating network intro-net
Starting redis (redis:7)
redis.intro.opossum
Starting web (nginx:alpine)
web.intro.opossum
↳ web on the host: localhost:8080
It starts the services in dependency order (redis before web, because web
depends_on it) and tells you where to reach a published service from the host —
localhost:8080.
opossum ps
Same output you'd expect from docker compose ps:
$ opossum ps
SERVICE CONTAINER IMAGE IP PORTS STATUS
redis redis.intro.opossum redis:7 192.168.67.2 - running
web web.intro.opossum nginx:alpine 192.168.67.3 0.0.0.0:8080->80/tcp running
Open http://localhost:8080 in your browser (or curl it) and you get nginx:
$ curl -s http://localhost:8080/ | head -4
<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>
Services find each other by name
Just like Compose, peers reach each other by their service name over the
project's network. From inside the web container, redis resolves:
$ opossum exec web sh -c "getent hosts redis"
... redis.intro.opossum redis
So your app connects to redis:6379 — no IPs, no hardcoding.
opossum logs and opossum stats
Follow logs like usual:
$ opossum logs redis
...
1:M 06 Jul 2026 16:43:09.983 * Ready to accept connections tcp
And there's a docker stats–style live view of resource usage per service:
$ opossum stats --no-stream
Container ID Cpu % Memory Usage Net Rx/Tx Block I/O Pids
redis.intro.opossum 0.74% 29.91 MiB / 1.00 GiB 16.18 KiB / 0.57 KiB 25.68 MiB / 0.00 KiB 6
web.intro.opossum 0.00% 15.48 MiB / 1.00 GiB 15.15 KiB / 2.14 KiB 9.94 MiB / 4.00 KiB 6
opossum down
$ opossum down
Stopping web
Stopping redis
Tears everything down in reverse order and removes the project network. Add -v
to also drop named volumes.
It's almost the same as docker compose
If you know Compose, you already know opossum. The everyday commands map 1:1:
| You'd type in Compose | With opossum |
|---|---|
docker compose up | opossum up |
docker compose ps | opossum ps |
docker compose logs -f web | opossum logs web -f |
docker compose exec web sh | opossum exec -it web sh |
docker compose down -v | opossum down -v |
opossum also has stats, images, pull, build, run, start/stop/
restart/kill, and config — the usual toolbox.
A few honest differences, since it targets Apple's runtime rather than Docker:
One-time setup: thesudo container system dns create opossumstep above,
which is what makes bare-name service discovery work.
Runtime: it's Applecontainer(a per-container lightweight VM), not Docker
Engine. Compose fields the runtime can't act on (like customnetworks:or
container_name:) are parsed and warned about, not silently dropped.
macOS 26 + Apple silicon only.
Try it
brew install suruseas/opossum/opossum
cd your-project-with-a-compose-file
opossum up
Repo: https://github.com/suruseas/opossum. If you have a docker-compose.yml
lying around, give opossum up a try and see how far it gets — for a lot of
stacks, the answer is "all the way."