Skip to content

Commit

Permalink
Replace podman helm instructions with miniChRIS-podman instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
jennydaman committed Feb 4, 2025
1 parent b332261 commit 4fa7695
Showing 1 changed file with 4 additions and 72 deletions.
76 changes: 4 additions & 72 deletions docs/run/podman/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,6 @@ sidebar_position: 0

# _ChRIS_ on Podman

::::danger

This page is WIP.

::::

## Introduction

[Podman](https://podman.io) is a rootless, daemon-less\*,
Expand All @@ -29,9 +23,8 @@ kubelet and containerd in Podman containers.

## System Requirements

Podman version 4.3 or above is required.
Podman version 4.9.3 or above is required.
We aim to support "out-of-the-box" setups of rootless Podman (using slirp4netns and aardvark-dns).
_ChRIS_ on Podman has previously been tried and worked on: Fedora Silverblue 37, Ubuntu 22.04, and Arch Linux.

<details>
<summary>
Expand All @@ -49,71 +42,10 @@ sudo usermod --add-subuids 100000-165535 --add-subgids 100000-165535 $USER

</details>

:::warning

Podman version 4.6.2 does not work due to a [bug](https://github.com/containers/podman/issues/19930).
If `pman` is reporting the error

> crun: write to `/proc/self/oom_score_adj`: Permission denied: OCI permission denied
Try downgrading `crun` to version 1.8.7.
(On Arch Linux, run `sudo pacman -U /var/cache/pacman/pkg/crun-1.8.7-1-x86_64.pkg.tar.zst`)

:::

## Dependencies

In addition to Podman, you also need to have [Helm](https://helm.sh/) installed.

## Configuration

_ChRIS_ runs containers of its own, so you need to run a Podman socket.
On systemd GNU/Linux, run

```shell
systemctl --user start podman.service
```

Create a `values.yaml` configuration file:

```shell
git clone https://github.com/FNNDSC/charts.git fnndsc-charts
cd fnndsc-charts/podman
./init.sh > values.yaml
```

## Usage

First, set your working directory to the `fnndsc-charts` repo cloned above.

### Startup

```shell
helm template chris ./charts/chris -f podman/values.yaml | podman kube play --replace -
```

### Shutdown

```shell
helm template chris ./charts/chris -f podman/values.yaml | podman kube down -
```

### Shutdown and Delete Data

```shell
helm template chris ./charts/chris -f podman/values.yaml | podman kube down --force -
git clone https://github.com/FNNDSC/miniChRIS-podman.git
cd miniChRIS-podman
./minichris.sh
```

### Use Podman Desktop

You need to generate the Kubernetes YAML first:

```shell
helm template chris ./charts/chris -f podman/values.yaml > chris.yaml
```

TODO TODO TODO

### ChRIS_ui

TODO TODO TODO

0 comments on commit 4fa7695

Please sign in to comment.