MyOS - Develop and Share Linux Environments

If you like the project, please remember to star it so we can grow the community!

Blog post about MyOS | Dockerhub

If you want your environment listed in the showcase, please submit a PR

High Level

Uses Docker + Docker Compose to provide a consistent and reproducible build environment. Base image assumes the minimum while still being useful out of the box.

Usage

Assumptions

Everything depends on myos base Docker image. This image is available on Dockerhub, but you may also build it using the included Dockerfile.

OSX Users: For display forwarding to work, you'll need to have X11 Quartz. It's crappy and I'd love to find an alternative.

Ctrl-D is the most sure fire way of getting out of the container

Setup

1. Clone the repo

   $ git clone https://github.com/rylandg/myos.git
   

2. Alias the CLI or add it to your PATH

   alias myos="/path/to/myos/repo/myos.sh"
   

3. Create a template environment with empty config files

   $ myos init ./somepath/
   $ ls somepath
     vim tmux zsh docker-compose.yml
   

4. Enter directory and create your environment

   $ cd somepath
   $ myos create testmyos 
   

5. Connect to the environment via ssh

   $ myos connect testmyos
   

6. Bring down the environment when you're done (this can lose data)

   $ myos remove testmyos
   

Advanced usage

Assuming you've already installed the tool, my personal configuration can be used to test out MyOS.

1. Clone my personal MyOS config

$ git clone https://github.com/rylandg/rylandg-myosfiles

2. Create a MyOS based on my setup

$ cd rylandg-myosfiles
$ myos create rysetup
$ myos connect rysetup

API

Init

myos init <dir>

Creates the initial templates that the default docker-compose.yml expects. These are...

# vim
vim/binds.vim
vim/helpers.vim
vim/plugins.vim
vim/vimrc
# zsh
zsh/.zlogin
zsh/.zprofile
zsh/.zshenv
zsh/.zshrc
# tmux
tmux/tmux_saves
tmux/install_tmux.sh
tmux/tmux.conf

These files are empty (for the most part). You're expected to add your environment specific settings.

Create

myos create <envName>

Runs docker-compose up -d from the current directory

Connect

myos connect <envName>

Connects to a previously created MyOS environment

Restart

myos restart <envName>

Restart a previously created MyOS environment

Remove

myos remove <envName>

Remove a running MyOS environment

Features

• Configuring locale and colors
• Creating a non-root user and setting necessary permissions
• Setups OpenSSH for password-less login
• Enabling X11 Display server
• Super light, highly optimized base Ubuntu image
• Mechanism to "safely" run multiple processes
• Init for running your user process as PID > 1
• OpenSSH server out of the box
• ZSH
• HTop
• Vim8 with clipboard support
• Latest Tmux built from source
• XAuth and XDisplay packages for clipboard support

Issues/planned changes

• Very vim focused, would like to see if its possible to support other editors (definitely Emacs)
• Needs CLI command that allows you to copy another users MyOS environment

Contributors

Thanks goes to these wonderful people (emoji key):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore --> <table><tr><td align="center"><a href="https://github.com/dimensi0n"><img src="https://avatars3.githubusercontent.com/u/25726586?v=4" width="100px;" alt="Erwan ROUSSEL"/><br />_{<b>Erwan ROUSSEL</b>}</a><br /><a href="https://github.com/rylandg/myos/commits?author=dimensi0n" title="Documentation">📖</a></td><td align="center"><a href="https://benyanke.com"><img src="https://avatars1.githubusercontent.com/u/4274911?v=4" width="100px;" alt="Ben Yanke"/><br />_{<b>Ben Yanke</b>}</a><br /><a href="https://github.com/rylandg/myos/commits?author=benyanke" title="Code">💻</a></td><td align="center"><a href="https://github.com/marcopiraccini"><img src="https://avatars0.githubusercontent.com/u/668050?v=4" width="100px;" alt="Marco"/><br />_<b>Marco</b></a><br /><a href="https://github.com/rylandg/myos/issues?q=author%3Amarcopiraccini" title="Bug reports">🐛</a></td><td align="center"><a href="https://toke.love"><img src="https://avatars3.githubusercontent.com/u/2603109?v=4" width="100px;" alt="Aaron Tokelove"/><br />_{<b>Aaron Tokelove</b>}</a><br /><a href="https://github.com/rylandg/myos/issues?q=author%3Atokelove" title="Bug reports">🐛</a></td><td align="center"><a href="http://www.binaris.com"><img src="https://avatars0.githubusercontent.com/u/27736122?v=4" width="100px;" alt="Ryland Goldstein"/><br />_{<b>Ryland Goldstein</b>}</a><br /><a href="#projectManagement-rylandg" title="Project Management">📆</a> <a href="#blog-rylandg" title="Blogposts">📝</a></td><td align="center"><a href="https://github.com/muniter"><img src="https://avatars2.githubusercontent.com/u/9699804?v=4" width="100px;" alt="Javier Lopez"/><br />_{<b>Javier Lopez</b>}</a><br /><a href="https://github.com/rylandg/myos/issues?q=author%3Amuniter" title="Bug reports">🐛</a></td><td align="center"><a href="http://lvm.github.io"><img src="https://avatars1.githubusercontent.com/u/34095?v=4" width="100px;" alt="Mauro"/><br />_<b>Mauro</b></a><br /><a href="#question-lvm" title="Answering Questions">💬</a></td></tr></table> <!-- ALL-CONTRIBUTORS-LIST:END -->

This project follows the all-contributors specification. Contributions of any kind welcome!