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.22.0.tar.gz (6.4 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.22.0-py3-none-any.whl (8.6 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for mimchine-0.22.0.tar.gz
Algorithm Hash digest
SHA256 3b7420b18060cf31258a7c4b9b55dc05a25e5909821787d839b0438560d7ab05
MD5 8ea34a50192bfefadf4aac359986aaaf
BLAKE2b-256 041173b46e74641fa2a71e06941e0986624afe47441681481ca3f31908b8727c

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for mimchine-0.22.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a9bd56b31dee16aeaef61881f8ad0266b2d3425c202e722548d0344a5eb811a2
MD5 c7c8a7812df4c2e51c1012ff2141cc27
BLAKE2b-256 a7111f66132ca0ec5c2a395397c010e50992635feaa015e14a4025e67281b78a

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