webuntumac (depreciated)

ubuntu 4.4.15-moby x86_64 GNU/Linux accessible from the browser, on your mac.

Table of Contents

• Requirements
• Features
• Installation
• Pull
• Build
• Uninstall
• Connect
• Troubleshooting
• Dependencies
• Questions
• License

Requirements

A Mac
Docker for Mac
A web browser

Features

• ubuntu root [web] shell with the ability to open many concurrent shells.
• openbox [web] GUI with firefox pre-installed, multiple desktops for productivity.
• vmstat [web] live system statistics.
• includes: python, tmux, vim, nano, feh, terminator, unzip, wget and atop.

Installation

You can pull, install & start the webuntumac container using this command within the Docker Terminal:

docker run -h webuntumac -p 6080:6080 -p 369:369 -p 80:80 -p 88:8010 -d -i mattinclude/webuntumac

Run webuntumac with logging:

docker run -h webuntumac -p 6080:6080 -p 369:369 -p 80:80 -p 88:8010 -t -i mattinclude/webuntumac

Run webuntumac with persistent storage directory:

docker run -v webuntumac:/root/storage -h webuntumac -p 6080:6080 -p 369:369 -p 80:80 -p 88:8010 -d -i mattinclude/webuntumac

Pull

docker pull mattinclude/webuntumac

Build

git clone https://github.com/mattinclude/webuntumac.git


docker build --rm -t mattinclude/webuntumac webuntumac


docker run -d -h webuntumac -p 6080:6080 -p 369:369 -p 80:80 -p 88:8010 -d -i mattinclude/webuntumac

Connect

Open a web browser and navigate to: localhost.

Uninstall

Stop & Remove webuntumac using this command within the Docker Terminal:

docker stop $(docker ps -a -q | grep -v mattinclude/webuntumac) && docker rmi -f mattinclude/webuntumac

Stop / Remove ALL docker containers:

docker stop $(docker ps -a -q) 

docker rm $(docker ps -a -q)

Troubleshooting

Docker: dial tcp: lookup index.docker.io: no such host

docker-machine ssh default 

sudo sed -i '1s/^/nameserver 8.8.8.8\n/' /etc/resolv.conf && exit

web-gui: Cannot Type, Keyboard Input Not Detected. Click the title bar at the top of the novnc ubuntu window that says:

Connected (unencrypted) to: webuntumac:1

Your keyboard input now functions as expected.

Dependencies

ubuntu
pm2
noVNC
web-vmstats

Questions

Contact me at matt@brassey.io with any questions or comments.

License

webuntumac is published under the CC0_1.0_Universal license.

The Creative Commons CC0 Public Domain Dedication waives copyright interest in a work you've created and dedicates it to the world-wide public domain. Use CC0 to opt out of copyright entirely and ensure your work has the widest reach. As with the Unlicense and typical software licenses, CC0 disclaims warranties. CC0 is very similar to the Unlicense.