Skip to content

Unable to run Localnet on Raspberry Pi 5 with Debian 12 #695

@SilentRhetoric

Description

@SilentRhetoric

Subject of the issue

Running into two issues, potentially unrelated, but both included here:

  1. Running algokit localnet start doesn't detect the container engine, yet Docker is running
  2. Trying to run algokit localnet config causes an unhandled error

Your environment

brian@pi5-16:~ $ cat /etc/os-release
PRETTY_NAME="Debian GNU/Linux 12 (bookworm)"
NAME="Debian GNU/Linux"
VERSION_ID="12"
VERSION="12 (bookworm)"
VERSION_CODENAME=bookworm
ID=debian
HOME_URL="https://www.debian.org/"
SUPPORT_URL="https://www.debian.org/support"
BUG_REPORT_URL="https://bugs.debian.org/"

brian@pi5-16:~ $ algokit doctor
HTTP Request: GET https://api.github.com/repos/algorandfoundation/algokit-cli/releases/latest "HTTP/1.1 200 OK"
timestamp: 2025-09-26T22:00:04+00:00
AlgoKit: 2.9.1
AlgoKit Python: 3.11.2 (main, Apr 28 2025, 14:11:48) [GCC 12.2.0] (location: /home/brian/.local/pipx/venvs/algokit)
OS: Linux-6.12.47+rpt-rpi-2712-aarch64-with-glibc2.36
docker: 28.4.0
docker compose: 2.39.4
git: 2.39.5
python: 3.11.2 (location: /usr/bin/python)
python3: 3.11.2 (location: /usr/bin/python3)
pipx: 1.1.0
poetry: 2.2.1
node: 24.9.0
npm: 11.6.0

brian@pi5-16:~ $ sudo systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Fri 2025-09-26 17:39:58 EDT; 10min ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 836 (dockerd)
      Tasks: 10
        CPU: 378ms
     CGroup: /system.slice/docker.service
             └─836 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

Steps to reproduce

brian@pi5-16:~ $ algokit localnet start
Error: Container engine isn't running; please start it.

brian@pi5-16:~ $ algokit localnet config
? Which container engine do you prefer? Docker (Active)
Unhandled TypeError: unsupported operand type(s) for 'in': 'str' and 'EnumType'

Expected behaviour

To be able to run Localnet, and for the configuration command to work successfully.

Actual behaviour

Can't start Localnet, and trying to configure it produces the Unhandled TypeError.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions