Skip to content

natesitton80/userspace

 
 

Repository files navigation

Bring Your Own Userspace (BYOB) Publish Docker Image

Dotfile & dev environment dependency management using Dotbot and Docker.

Quick uptime with containerized dotfiles and minimal dependency installation on host. Most dependencies exist in the ecarlson94/userspace container image and the container is executed like a binary through shims links (currently only a zsh wrapper around shim.sh is needed).

If you want to view the dotfiles used within the container, please review ecarlson94/dotfiles.

The structure of this repository is heavily inspired by vsund and vbrandl.

Table of Contents

Dependencies

  • git
  • docker (automatically installed)

Installation

~$ git clone --recursive https://github.com/ecarlson94/userspace.git ~/.userspace
~$ cd ~/.userspace

For installing a predefined profile:

~/.userpsace$ ./install-profile <profile> [<configs...>]

See meta/profiles/ for available profiles

For installing single configurations:

~/.userpsace$ ./install-standalone <configs...>

See meta/configs/ for available configurations

Note: Any configuration can be run as sudo by adding -sudo to the end of it when invoking the install script. DO NOT run the script as a sudoer.

Post-Installation

You can run the above installation commands safely multiple times, if you think that helps with better installation.

Mac or Ubuntu Desktop

  1. Exit terminal
  2. Start Alacritty

WSL or headless linux

  1. Restart terminal
  2. Run zsh
  3. (WSL) Run compaudit | xargs chmod go-w

Acquiring the latest image

  1. Quit Alacritty
  2. Open terminal
  3. Run docker rmi ghcr.io/ecarlson94/userspace:main
  4. Reopen Alacritty

Contents

Profiles

meta/profiles
├── garuda-linux
├── kde-sweet
├── kubuntu
├── mac
├── ubuntu
└── ubuntu-desktop

License

This software is hereby released under an MIT License. That means you can do whatever you want with conditions only requiring preservation of copyright and license notices. See LICENSE for details.

About

Build dev container using dotfiles

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 53.1%
  • Dockerfile 46.9%