Support Podman

.github/workflows/ci.yml

@@ -34,7 +34,7 @@ jobs:
                 python-version: ['3.8', '3.9', '3.10', '3.11']
                 default-image:
                     - ''  # use the application default
-                    - aiidalab/aiidalab-docker-stack:latest
+                    - aiidalab/aiidalab-docker-stack:latest  # This is the old stack
 
         steps:
 
@@ -55,7 +55,7 @@ jobs:
 
             - name: Run tests
               run: |
-                  pytest -sv --slow --default-image=${{ matrix.default-image }}
+                  pytest -svv --slow --default-image=${{ matrix.default-image }}
                   coverage xml
 
             - name: Upload coverage to Codecov

README.md

@@ -12,7 +12,7 @@ AiiDAlab Launch makes it easy to run AiiDAlab on your own workstation or laptop.
 
 To use AiiDAlab launch you will have to
 
-1. [Install Docker on your workstation or laptop.](https://docs.docker.com/get-docker/)
+1. [Install Docker on your workstation or laptop.](https://docs.docker.com/get-docker/) (you can also use Podman, [see below](README.md#using-podman))
 2. Install AiiDAlab launch with [pipx](https://pypa.github.io/pipx/installation/) (**recommended**):
 
    ```console
@@ -70,6 +70,17 @@ Please see [here](ssh-forward.md) for instructions on how to run AiiDAlab on a r
 
 This package follows the Python compatibility and deprecation schedule specified by [NEP 29](https://numpy.org/neps/nep-0029-deprecation_policy.html).
 
+### Using Podman instead of Docker
+
+You should be able to use Podman as as a drop-in replacement for Docker, with just a little extra setup. The following was tested on Fedora 39 which comes with Podman pre-installed.
+
+```console
+systemctl --user enable podman.socket
+systemctl --user start podman.socket
+systemctl --user status podman.socket
+export DOCKER_HOST=unix:///run/user/$UID/podman/podman.sock
+```
+
 ## Development
 
 ### Setting up a development environment
@@ -162,7 +173,7 @@ SOFTWARE.
 ## Acknowledgements
 
 This work is supported by the
-[MARVEL National Centre for Competency in Research](<http://nccr-marvel.ch>) funded by the [Swiss National Science Foundation](<http://www.snf.ch/en>),
+[MARVEL National Centre for Competency in Research](<https://nccr-marvel.ch>) funded by the [Swiss National Science Foundation](<https://www.snf.ch/en>),
 the MARKETPLACE project funded by [Horizon 2020](https://ec.europa.eu/programmes/horizon2020/) under the H2020-NMBP-25-2017 call (Grant No. 760173),
 as well as by the [MaX
 European Centre of Excellence](<http://www.max-centre.eu/>) funded by the Horizon 2020 EINFRA-5 program,

aiidalab_launch/profile.py

@@ -31,7 +31,7 @@ def _default_port() -> int:  # explicit function required to enable test patchin
     return DEFAULT_PORT
 
 
-DEFAULT_IMAGE = "aiidalab/full-stack:latest"
+DEFAULT_IMAGE = "docker.io/aiidalab/full-stack:latest"
 
 
 def _valid_volume_name(source: str) -> None:
@@ -49,8 +49,8 @@ def _get_configured_host_port(container: Container) -> int | None:
     try:
         host_config = container.attrs["HostConfig"]
         return int(host_config["PortBindings"]["8888/tcp"][0]["HostPort"]) or None
-    except (KeyError, IndexError, ValueError):
-        pass
+    except (KeyError, IndexError, ValueError) as e:
+        raise
     return None
 
 
@@ -158,11 +158,13 @@ def from_container(cls, container: Container) -> Profile:
 
         system_user = get_docker_env(container, "SYSTEM_USER")
 
+        print(container.image.tags)
         image_tag = (
             DEFAULT_IMAGE
             if DEFAULT_IMAGE in container.image.tags
             else container.image.tags[0]
         )
+        print(f"{image_tag!r}")
 
         extra_destinations: list[PurePosixPath] = [
             PurePosixPath(mount["Destination"])
@@ -178,6 +180,8 @@ def from_container(cls, container: Container) -> Profile:
             else:
                 extra_mounts.add(":".join([str(src), str(dst), "rw"]))
 
+        print(_get_configured_host_port(container))
+
         return Profile(
             name=profile_name,
             port=_get_configured_host_port(container),

tests/conftest.py

@@ -78,7 +78,7 @@ def _pull_docker_image(docker_client):
 # Avoid interfering with used ports on the host system.
 @pytest.fixture(scope="session", autouse=True)
 def _default_port(monkeypatch_session):
-    monkeypatch_session.setattr(aiidalab_launch.profile, "DEFAULT_PORT", None)
+    monkeypatch_session.setattr(aiidalab_launch.profile, "DEFAULT_PORT", 7777)
     yield None