https://github.com/redthing1/mimchine
integrated mini-linux in podman. inspired by distrobox.
https://github.com/redthing1/mimchine
Last synced: 7 days ago
JSON representation
integrated mini-linux in podman. inspired by distrobox.
- Host: GitHub
- URL: https://github.com/redthing1/mimchine
- Owner: redthing1
- Created: 2023-08-17T07:50:54.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-26T23:37:58.000Z (22 days ago)
- Last Synced: 2025-04-27T00:23:57.550Z (22 days ago)
- Language: Python
- Homepage:
- Size: 52.7 KB
- Stars: 21
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-starred - redthing1/mimchine - integrated mini-linux in podman. inspired by distrobox. (Python)
README
# mimchine
well-integrated **mini-machines**; a portable linux that has all your data dirs mounted. inspired by [distrobox](https://github.com/89luca89/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:
```sh
podman machine init --volume /Users --volume /Volumes
podman machine stop && ulimit -n unlimited && podman machine start
```
## usage
### build a mimchine image
```sh
mimchine build -f ./demo/mim_fed.docker -n mim_fed
```
### create a mimchine
```sh
mimchine create -n mim_fed -H ~/Downloads
```
### open a shell in a mimchine
```sh
mimchine shell -c mim_fed
```
### destroy a mimchine
```sh
mimchine destroy -c mim_fed -f
```