From 8096b7f4009083606a1ec1adcd311f8d2ff6070c Mon Sep 17 00:00:00 2001 From: KoNicks <61112636+KoNickss@users.noreply.github.com> Date: Thu, 14 Jan 2021 00:16:11 +0200 Subject: [PATCH 1/5] Update README.md --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index e0958ff..7564d65 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,8 @@ First of all, open a terminal and run this command: ### `curl https://koffe.netlify.app/install-host | sudo bash` This creates some configs and add some file we will need for the installation. After the script finishes, from the archlinux website go to a mirror near you and download the .tar.gz bootstrap image and unzip it in `/usr/share/koffe/archbox` so that `/usr/share/koffe/archbox/bin` is a valid folder. -After you're done unziping the image, edit `/usr/share/koffe/archbox/etc/pacman.d/mirrorlist` and uncomment a mirror. Then you should be able to run `koffe-shell` to enter the container, after that run `curl https://koffe.netlify.app/install-box | bash` and `pacman -Syu` to add the necessary files. After that just exit and re-enter the container and you should be able to use it. +After you're done unziping the image, edit `/usr/share/koffe/archbox/etc/pacman.d/mirrorlist` and uncomment a mirror. Then you should be able to run `koffe-shell` to enter the container, after that run +### `curl https://koffe.netlify.app/install-box | bash` and `pacman -Syu` to add the necessary files. After that just exit and re-enter the container and you should be able to use it. ## Usage After you do `koffe-shell` to enter the container, you can do `help-koffe` to list commands, I'm gonna list the steps of making a basic iso. ### 1.Register the packages (you only have to do this once) From 64cd3693cce24c494c82505926759874b59a48ee Mon Sep 17 00:00:00 2001 From: KoNicks <61112636+KoNickss@users.noreply.github.com> Date: Thu, 14 Jan 2021 00:16:45 +0200 Subject: [PATCH 2/5] Update README.md --- README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 7564d65..9df2ece 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# koffe [NOT FUNCTIONAL YET] +# koffe koffe is a great tool for making intuitive, offline archlinux installers. Since some steps for mastering an arch iso require arch-linux, everything runs inside a container you have to create yourself. Every package installed to the new computer via the installer are from the repo, including base and linux, so no copy-pasting from the iso that could cause issues later. # Documentation ## Installation @@ -7,7 +7,8 @@ First of all, open a terminal and run this command: This creates some configs and add some file we will need for the installation. After the script finishes, from the archlinux website go to a mirror near you and download the .tar.gz bootstrap image and unzip it in `/usr/share/koffe/archbox` so that `/usr/share/koffe/archbox/bin` is a valid folder. After you're done unziping the image, edit `/usr/share/koffe/archbox/etc/pacman.d/mirrorlist` and uncomment a mirror. Then you should be able to run `koffe-shell` to enter the container, after that run -### `curl https://koffe.netlify.app/install-box | bash` and `pacman -Syu` to add the necessary files. After that just exit and re-enter the container and you should be able to use it. +### `curl https://koffe.netlify.app/install-box | bash` +and `pacman -Syu` to add the necessary files. After that just exit and re-enter the container and you should be able to use it. ## Usage After you do `koffe-shell` to enter the container, you can do `help-koffe` to list commands, I'm gonna list the steps of making a basic iso. ### 1.Register the packages (you only have to do this once) From e6e0f7c2768439a958433784f50986eeb77dd86d Mon Sep 17 00:00:00 2001 From: KoNicks <61112636+KoNickss@users.noreply.github.com> Date: Thu, 14 Jan 2021 00:17:22 +0200 Subject: [PATCH 3/5] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9df2ece..a96f68e 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ After you're done unziping the image, edit `/usr/share/koffe/archbox/etc/pacman. ### `curl https://koffe.netlify.app/install-box | bash` and `pacman -Syu` to add the necessary files. After that just exit and re-enter the container and you should be able to use it. ## Usage -After you do `koffe-shell` to enter the container, you can do `help-koffe` to list commands, I'm gonna list the steps of making a basic iso. +After you do `koffe-shell` to enter the container, you can do `helpme` to list commands, I'm gonna list the steps of making a basic iso. ### 1.Register the packages (you only have to do this once) To do that, use the command `register package-name` #### !!IMPORTANT!! : you need these following packages for even the most basic of installs: base, linux, linux-firmware, libnewt (for the script) and grub, register them before any other packages. From 17bf0ae19664a94ec802e48604474e9fdfcbfb85 Mon Sep 17 00:00:00 2001 From: KoNicks <61112636+KoNickss@users.noreply.github.com> Date: Thu, 14 Jan 2021 00:25:45 +0200 Subject: [PATCH 4/5] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index a96f68e..88323b4 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ After you do `koffe-shell` to enter the container, you can do `helpme` to list c ### 1.Register the packages (you only have to do this once) To do that, use the command `register package-name` #### !!IMPORTANT!! : you need these following packages for even the most basic of installs: base, linux, linux-firmware, libnewt (for the script) and grub, register them before any other packages. -If you package is a group (like gnome, xorg, plasma) do register-g instead of register. +If the package is actually a group (like gnome, xorg, plasma) do register-g instead of register. TIP: To make package groups, simply make a folder in /arch/pkgs and move all packages you want to put in said group in that folder, afther that when you select the folder it'll fetch everything in it. ### 2. Make the iso Run `iso-make`, you will be prompted with a screen where you can choose what packages (from the registered ones) to download for the installation, once again you need the packages listed in step 1 for even the most basic installs, so add them for a healthy install. After you're done choosing the packages and downloading them, choose the "done" option at the very bottom and let the iso generate. From 5c5f971b19c17e6d169949a7d1cdb44151f14b3a Mon Sep 17 00:00:00 2001 From: KoNicks <61112636+KoNickss@users.noreply.github.com> Date: Thu, 14 Jan 2021 00:29:25 +0200 Subject: [PATCH 5/5] Update README.md --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 88323b4..732389b 100644 --- a/README.md +++ b/README.md @@ -11,17 +11,17 @@ After you're done unziping the image, edit `/usr/share/koffe/archbox/etc/pacman. and `pacman -Syu` to add the necessary files. After that just exit and re-enter the container and you should be able to use it. ## Usage After you do `koffe-shell` to enter the container, you can do `helpme` to list commands, I'm gonna list the steps of making a basic iso. -### 1.Register the packages (you only have to do this once) +### 1.Registering the packages (you only have to do this once) To do that, use the command `register package-name` #### !!IMPORTANT!! : you need these following packages for even the most basic of installs: base, linux, linux-firmware, libnewt (for the script) and grub, register them before any other packages. If the package is actually a group (like gnome, xorg, plasma) do register-g instead of register. -TIP: To make package groups, simply make a folder in /arch/pkgs and move all packages you want to put in said group in that folder, afther that when you select the folder it'll fetch everything in it. -### 2. Make the iso +TIP: To make package groups, simply make a folder in /arch/pkgs and move all packages you want to put in said group in that folder, after that when you select the folder it'll fetch everything in it. +### 2. Making the iso Run `iso-make`, you will be prompted with a screen where you can choose what packages (from the registered ones) to download for the installation, once again you need the packages listed in step 1 for even the most basic installs, so add them for a healthy install. After you're done choosing the packages and downloading them, choose the "done" option at the very bottom and let the iso generate. ### 3. Collect and use the iso The iso will be copied from the container to the home folder after you run `exit`, pick it up from there and use it, you can flash it to a usb, burn it to a disk or mount it to a virtual machine. ### 4. Installing -Boot from the iso and run `bash install` in the live env, this should start the installer right away, just follow the steps keeping these steps in mind: +Boot from the iso and run `bash install` in the live env, this should start the installer right away, just follow the steps keeping these things in mind: In cfdisk you need at least one partition with the type set as "linux", you can also add one with a "swap" label as long as it is about 1.5 times as big as your ram storage (but this is optional), if you're on uefi create a 500 MB fat32 partition and if you're on mbr/legacy tick the 'bootable' option for the linux partition. Make sure to memorise or write down what partiton (/dev/name) is used for what as you will need to fill that in later. -### 4. Tips for advanced users +### Tips for advanced users: You can edit /arch/scripts/ to better suit your installation, koffe.is is what runs in the live env and pi.is is the post-install setup that runs in chroot.