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.21.0.tar.gz (5.2 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.21.0-py3-none-any.whl (7.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mimchine-0.21.0.tar.gz
  • Upload date:
  • Size: 5.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.1 CPython/3.13.2 Darwin/24.4.0

File hashes

Hashes for mimchine-0.21.0.tar.gz
Algorithm Hash digest
SHA256 359fdae0adb07bba3f13705f0563541f106215639f6bb4ccd7bfcc677ce68c7c
MD5 044f77b58807c836a197b3492a03902d
BLAKE2b-256 96b0825258f1ada4168dfd0359f80db31573d93f64bb417b1976b71ec9f88deb

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mimchine-0.21.0-py3-none-any.whl
  • Upload date:
  • Size: 7.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.1 CPython/3.13.2 Darwin/24.4.0

File hashes

Hashes for mimchine-0.21.0-py3-none-any.whl
Algorithm Hash digest
SHA256 91cbbcdd277f60679c906a8c26d8b81c6f2ae03807525ce70add65403c7b4301
MD5 75ecf1b62bd07d15db2bb4e3fa6e754f
BLAKE2b-256 77141f6282c9c82e1e8f68478e70cc6e7753e7f81d6dbc8418cdd42e39536977

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