|
1 year ago | |
---|---|---|
airootfs | 1 year ago | |
efiboot/loader | 2 years ago | |
syslinux | 1 year ago | |
LICENSE | 3 years ago | |
README.md | 1 year ago | |
packages.x86_64 | 1 year ago | |
pacman.conf | 2 years ago | |
profiledef.sh | 1 year ago |
README.md
❗Still in progress. The ISO does not yet contain a complete configuration.❗
But the arch installation is really quick. Just without any PwOSS configuration.
Create your own ISO
You need a working Arch system to create the ISO.
You can use VirtualBox or download the ISO directly.
Dependencies
sudo pacman -S archiso git
Build your ISO
git clone https://git.pwoss.org/server/iso.git
cd /path/to/repo/ISO/
mkarchiso -v .
NOTE:
It is recommended to perform all the following steps as the root user with the umask set to0022
. If not, it is very likely that the live environment will have wrong file permissions.
NOTE 2:
Changeprofiledef.sh
to your needs.
General options
Check mkarchiso -h
.
PwOSS - ISO
SSH
Check the given ip address of your router for archiso
.
Or nmap ...:
nmap -sn 192.168.1.0/24
Live ISO root user password is pwoss
.
Necessary modifications
Boot into your Live ISO and change the script before running it!
nano pwoss-server.sh
You NEED to change:
QDISKS="1" # Select the number "1" OR "2". If you have more than 2 hard drives, select 2.
ENCRYPTION="YES" # Select "YES" OR "NO" whether you want encryption or not.
That's the absolute minimum you have to change. Of course you can also change the passwords etc.. But stay between the 2 lines!
############################# Change only between the 2 lines
HDD or SSD
If you are installing Arch on a HDD hard disk instead of an SSD hard disk, you must delete root_trim=yes
from grub.
With Encryption:
nano etc/default/grub-luks
GRUB_CMDLINE_LINUX="cryptdevice=/dev/sda2:root root=/dev/vg0/root resume=/dev/vg0/swap root_trim=yes"
Without Encryption:
nano etc/default/grub
GRUB_CMDLINE_LINUX="root_trim=yes"
Packages
You can easily add or delete your own packages. Do NOT delete from package base
to $MICROCODE
(inlcuding $MICROCODE).
Usage
pwoss <[options]> -u [<username>]
pwoss <[options]> --username=[<username>]
Options:
-h --help show this message
-u --username set username e.g. $USERNAME
-p --password set user password e.g. $PASSWORD
-r --root-password set root password e.g. $PASSWORDROOT
-e --encryption set encryption e.g. $ENCRYPTION
-cr --crypt-root set root password e.g. $CRYPTPWDROOT
-ch --crypt-home set home password e.g. $CRYPTPWDHOME
-t --timezone set timezine e.g. $TIMEZONE
-q --quantity-disks set numbers of hd e.g. $QDISKS
-d --disk set install disk e.g. $HARDDISK
-d2 --disk2 set home disk e.g. $HARDDISK2
Install on Arch ISO
Boot into any Arch Linux ISO and type the following:
pacman -Sy git
git clone https://git.pwoss.org/server/iso.git
cd ISO/airootfs/
./pwoss-server.sh
Requirements
Hardware
Minimal system
- 512 megabyte (MB) of memory (RAM)
- 13 gigabytes (GB) of hard disk space
- A one gigahertz (GHz) processor
- A broadband internet connection
- x86_64-compatible machine
Recommended system
- 2 gigabyte (GB) of memory (RAM)
- 18 gigabytes (GB) of hard disk space
- A 2 gigahertz (GHz) processor
- A broadband internet connection
- x86_64-compatible machine
System architecture
The following items are also recommended:
- A reliable 1GB (or greater) USB stick
The USB Stick is necessary for the installation of the system. Also, having a reliable USB stick from a reputable brand will help ensure that the process goes smoothly.
Software
(Optional) Etcher
Download Etcher to flash the ISO
How To
BIOS
You have to align the boot-start to your USB-Stick.
Depending on your motherboard, you must press the "esc" or "f2" or "f12" or "end" key immediately after the PC starts.
Check your motherboard/computer manual if no button works or ask us.
Go to:
- Boot
- BOOT DEVICE PRIORITY (or similar)
Put the USB at the first place (with F5 and F6). Hit the button esc until save changes and reset. Hit enter and yes.
Reboot and choose Start: Boot Arch Linux (x86_64)
(After installing your operating system, you need to change back your BIOS settings)
Flashing the ISO file
lsblk
Note:
Check of=/dev/sdX, if it's really your USB Stick!!!
sudo dd bs=4M if=~/Downloads/pwoss-server-*.iso of=/dev/sdX status=progress
You can also use Etcher if you prefer a graphical user interface (GUI).