rusty/README.md

# My Hack Environment in a Docker Container

The container actually is based on rust:latest which itself is based on Debian (Bookworm). Maybe I will switch to the Debian image, or better switch to an Alpine based image in the future. Actually I prefer the Debian image because it makes it more flexible to me because sometimes I need the GNU libc to compile programs.

Why the name "rusty"? Because it is based on some earlier Docker stuff I made for compiling Rust code... And rusty just sounds cool.

My plan is to switch from Docker to native Linux Containers at some time but I am faster in building the prototype using Docker... ;)

## Prerequisites

 * Docker...! What a wonder... :)
 * Be sure to be a member of the docker group. Else you need to do all the next steps as user root. I will not cover this here!

## Get the code

    git clone https://git.xw3.org/hanez/rusty
    # or
    git clone git@git.xw3.org:hanez/rusty.git # (needs an account on git.xw3.org)
    cd rusty

## Prepare the environment

    mkdir -p home/$USER
    chown $USER:$USER home/$USER
    chmod 0750 home/$USER
    sudo chown root:root home
    sudo mkdir root
    sudo chown root:root root

## Configure your environment (Optional)

Optionally you can configure your $HOME directories (/home/$USER and /root). I do this by pulling my $HOME configuration from my Git server. Pulling my $HOME configuration will not work for you because you are not allowed to pull via the Git protocol. This is just an example on how I do it... E.g.:

    git clone git@git.xw3.org:hanez/home.git home/hanez/
    sudo git clone git@git.xw3.org:hanez/home.git root/

I manage these Git based $HOME directories/repositories outside of the container.

If you do not configure your $HOME directories here, the container's defaults will be used.

## Using docker compose

    docker compose build
    docker compose up -d
    docker attach rusty 

You can stop the container by executing "exit" or by hiting ctrl+c when attached. You can always detache the container when hiting ctrl+p and then ctrl+q. This is useful if you have a screen or a tmux session runningin your container, or maybe some other applications.

## Using the Dockerfile only (less comfortable and without shared directories)

I recommend not to do it this way! You have been warned!

    docker build -t rusty .
    docker run -it --entrypoint /bin/bash rusty