From b2678e8ee5ff4c3726897328f40259d6692ad7e7 Mon Sep 17 00:00:00 2001
From: Debarshi Ray <rishi@fedoraproject.org>
Date: Sep 25 2018 09:38:52 +0000
Subject: Add the rest of the files


---

diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..6a1e68e
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,22 @@
+FROM registry.fedoraproject.org/fedora:28
+
+ENV NAME=fedora-toolbox VERSION=28
+LABEL com.redhat.component="$NAME" \
+      name="$FGC/$NAME" \
+      version="$VERSION" \
+      usage="This image is meant to be used with the fedora-toolbox command" \
+      summary="Base image for creating Fedora toolbox containers" \
+      maintainer="Debarshi Ray <rishi@fedoraproject.org>"
+
+COPY README.md /
+
+RUN sed -i '/tsflags=nodocs/d' /etc/dnf/dnf.conf
+RUN dnf -y swap coreutils-single coreutils-full
+
+COPY extra-packages /
+RUN packages=; while read -r package; do packages="$packages $package"; done \
+        <extra-packages; \
+    dnf -y install $packages
+RUN rm /extra-packages
+
+CMD /bin/sh
diff --git a/README.md b/README.md
index 7fad672..bea73c5 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,48 @@
-# fedora-toolbox
+# Fedora Toolbox — Hacking on your OSTree-based Fedora
+
+[Fedora Toolbox](https://github.com/debarshiray/fedora-toolbox) is a tool that
+offers a familiar RPM based environment for developing and debugging software
+on locked down [OSTree](https://ostree.readthedocs.io/en/latest/) based Fedora
+systems like [Silverblue](https://silverblue.fedoraproject.org/). Such
+operating systems are shipped as *immutable* OSTree images, where it's
+difficult to setup a development environment with your favorite tools, editors
+and SDKs. A toolbox container solves that problem by providing a RPM based
+*mutable* container. You can tweak it to your heart's content and use DNF to
+install your favorite packages, all without worrying about breaking your
+operating system.
+
+The toolbox environment is based on the `fedora-toolbox` image. This image is
+then customized for the current user to create a toolbox container that
+seamlessly integrates with the rest of the operating system.
+
+## Usage
+
+### Create the basic Fedora Toolbox image:
+```
+[user@hostname fedora-toolbox]$ buildah bud --tag fedora-toolbox:28 .
+STEP 1: FROM docker://registry.fedoraproject.org/fedora:28
+Getting image source signatures
+…
+…
+…
+[user@hostname fedora-toolbox]$
+```
+Modify the Dockerfile to match your taste and Fedora version. The image should
+be tagged as `fedora-toolbox` with a suffix matching the host Fedora version.
+eg., `fedora-toolbox:29`, etc..
+
+### Create your Fedora Toolbox container:
+```
+[user@hostname fedora-toolbox]$ ./fedora-toolbox create
+[user@hostname fedora-toolbox]$
+```
+This will create a container, and an image, called
+`fedora-toolbox-<your-username>:28` that's specifically customised for your
+host user.
+
+### Enter the Toolbox:
+```
+[user@hostname fedora-toolbox]$ ./fedora-toolbox enter
+🔹[user@toolbox ~]$
+```
 
-The fedora-toolbox package
\ No newline at end of file
diff --git a/extra-packages b/extra-packages
new file mode 100644
index 0000000..bcfb241
--- /dev/null
+++ b/extra-packages
@@ -0,0 +1,37 @@
+bash-completion
+bzip2
+diffutils
+dnf-plugins-core
+fpaste
+findutils
+git
+gnupg
+gnupg2-smime
+hostname
+iputils
+jwhois
+keyutils
+less
+lsof
+man-db
+man-pages
+mlocate
+mtr
+openssh-clients
+PackageKit-command-not-found
+passwd
+pigz
+procps-ng
+rsync
+sudo
+tcpdump
+time
+traceroute
+tree
+unzip
+vte-profile
+wget
+which
+words
+xz
+zip