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.25.0.tar.gz (8.1 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.25.0-py3-none-any.whl (9.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mimchine-0.25.0.tar.gz
  • Upload date:
  • Size: 8.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.4 CPython/3.13.5 Darwin/24.5.0

File hashes

Hashes for mimchine-0.25.0.tar.gz
Algorithm Hash digest
SHA256 2fb3b18b25698007a8276e6756893a60927621621887e21184c9b4df797591bc
MD5 5b88e976c030deacb8082a27c89c719b
BLAKE2b-256 1a69c53b8cc899a71fc1acd24ebc30375b34b77ebf2fb764a5347e66283e4459

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mimchine-0.25.0-py3-none-any.whl
  • Upload date:
  • Size: 9.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.4 CPython/3.13.5 Darwin/24.5.0

File hashes

Hashes for mimchine-0.25.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cfd12a0521bf6c5d5974acc10d3f8eef34313a6a6c16e0287179461b028d29de
MD5 e9d5ebfedcec047302c7e55eb4048fdc
BLAKE2b-256 eef4d87fbd2fac7eca86b2fbf2726aa658dbdbfa774367fb0a30795fa5fe31b1

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