MSG/msg-cli
1
0
Fork 0
Code Issues 3 Pull requests Projects Releases 2 Packages Wiki Activity Actions

Removed readme markdown file for org alternative

Browse source
This commit is contained in:
Chad Nelson 2025-02-15 13:05:55 -07:00
parent 9287eb7edb
commit 9531070a52
1 changed files with 0 additions and 86 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

86
README.md
View file

@ -1,86 +0,0 @@
# Table of Contents
1. [Overview](#org374b1bd)
2. [F.A.Q](#org162d875)
3. [Requirements](#orga3d4161)
4. [Installation](#org378e822)
5. [Usage](#orgc0d5aaf)
<a id="org374b1bd"></a>
# Overview
MSG is an attempt to create a native-like experience for Guix on MacOS, using methods inspired by others like Podman/Docker/Lima. It uses Qemu with a prebuilt installer image to create a customized local Guix instance (supported on Intel and Apple Silicon based Macs). The base image is pretty barebones and is meant to be customized to your liking. To get a good idea of whats included you can reference the /etc/config.scm file within the built image.
<a id="org162d875"></a>
# F.A.Q
- Q: Why does the cli generate the image locally instead of downloading a complete pre-built image like Podman?
- A: This is due to the final image requiring the admin account to be setup with the same UID as the host MacOS user. Podman accomplishes this by passing configuration values in it's ignition file, which are used to initialize the CoreOS image with the correct values on it's first run. Guix doesn't currently support a similar initialization method, so the image must be regenerated after the config has been updated with the correct values (UID, etc&#x2026;). This is unlikely to change in the near future, unless Guix ends up adding some sort of similar functionality.
- Q: What are the long term goals of this project?
- A: I would like for this project to accomplish a few goals.
1. Be able to fully replace docker/podman desktop on MacOS
2. Give users a way to manage their MacOS dotfiles using Guix Home
3. Improve GUI application performance with X11/Xquartz
4. Introduce a MSG Desktop GUI to accompany the cli
<a id="orga3d4161"></a>
# Requirements
- wget
- qemu
- autotools
- guile-next
- You can get guile-next from the following homebrew tap: <https://github.com/aconchillo/homebrew-guile>
- texinfo
These can be installed by running:
brew install autoconf automake libtool wget qemu texinfo guile-next
<a id="org378e822"></a>
# Installation
1. First clone this repository with:
git clone https://pagure.io/MSG/msg-cli.git msg
cd msg
2. Build and install the cli using:
autoreconf -vif && ./configure && make && sudo make install
3. Make sure to add the correct env vars set for guile-next/msg.
export GUILE_LOAD_PATH=/opt/homebrew/share/guile/site/3.0
export GUILE_LOAD_COMPILED_PATH=/opt/homebrew/lib/guile/3.0/site-ccache
export GUILE_SYSTEM_EXTENSIONS_PATH=/opt/homebrew/lib/guile/3.0/extensions
export GUILE_LOAD_PATH=$GUILE_LOAD_PATH:/usr/local/share/guile/site/3.0/
export GUILE_LOAD_COMPILED_PATH=$GUILE_LOAD_COMPILED_PATH:/usr/local/lib/guile/3.0/site-ccache/
export GUILE_SYSTEM_EXTENSIONS_PATH=$GUILE_SYSTEM_EXTENSIONS_PATH:/usr/local/lib/guile/3.0/extensions
export PATH=/usr/local/bin:$PATH
<a id="orgc0d5aaf"></a>
# Usage
- msg machine (command)
- init: initializes a new MSG instance
- reinit: reinitializes an MSG instance (is destructive!)
- start: starts the initialized MSG instance
- stop: stops the running instance
- msg shell
- Creates an ssh connection to the running instance