Skip to main content

well integrated mini machines with rootless podman

Project description

mimchine

well-integrated mini-machines; a portable linux that has all your data dirs mounted. inspired by distrobox and powered by podman.

what it's about

sometimes, i want a linux terminal development environment on macos, and i want all my data magically linked in. so that i can cd to a source directory and seamlessly build it.

with the power of containers, we can do just that. we run a linux userspace of our choice (fully customizable by a dockerfile), and mount in all our directories.

mimchine makes the above super easy. just build a machine image, create a container, then run mimchine shell and you're in!

setup

linux

should be all good to go

macos

ensure podman machine is initialized as such:

podman machine init --volume /Users --volume /Volumes
podman machine stop && ulimit -n unlimited && podman machine start

usage

build a mimchine image

mimchine build -f ./demo/mim_fed.docker -n mim_fed

create a mimchine

mimchine create -n mim_fed -H ~/Downloads

open a shell in a mimchine

mimchine shell -c mim_fed

destroy a mimchine

mimchine destroy -c mim_fed -f

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mimchine-0.24.0.tar.gz (8.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mimchine-0.24.0-py3-none-any.whl (9.8 kB view details)

Uploaded Python 3

File details

Details for the file mimchine-0.24.0.tar.gz.

File metadata

  • Download URL: mimchine-0.24.0.tar.gz
  • Upload date:
  • Size: 8.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.3 CPython/3.13.5 Darwin/24.4.0

File hashes

Hashes for mimchine-0.24.0.tar.gz
Algorithm Hash digest
SHA256 bc9a8fc92cbe45a11cb24819a8acb3a6fc949b5e35a05cd0c7f6b86000ffc489
MD5 6b90f2df93f4490324a15331e3aa479e
BLAKE2b-256 7e9ecac49760ec7120b43f95d0e1c774a42591985bd794da25d3746db2effb25

See more details on using hashes here.

File details

Details for the file mimchine-0.24.0-py3-none-any.whl.

File metadata

  • Download URL: mimchine-0.24.0-py3-none-any.whl
  • Upload date:
  • Size: 9.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.3 CPython/3.13.5 Darwin/24.4.0

File hashes

Hashes for mimchine-0.24.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0c845d73bfaaba9e32085dbfb560cbd936390e09c611eab9a31b52533bc9134a
MD5 636977c4f47721bd9aa3ae276b01433d
BLAKE2b-256 39458fcc2b7c47d29d3d262995d7ce65d0817b07d6feafe1c811270b5805c3f5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page