A fully functional server installation
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

199 lines
5.0 KiB

2 years ago
2 years ago
2 years ago
2 months ago
2 years ago
2 months ago
2 months ago
1 year ago
2 years ago
6 months ago
2 months ago
2 years ago
  1. ❗**Still in progress. The ISO does not yet contain a complete configuration.**❗
  2. But the arch installation is really quick. Just without any PwOSS configuration.
  3. [Download ISO](https://repo.pwoss.org/server/x86_64/iso/)
  4.  
  5. # Create your own ISO
  6. You need a working Arch system to create the ISO.
  7. You can use [VirtualBox](https://wiki.archlinux.org/index.php/VirtualBox) or download the [ISO](https://repo.pwoss.org/server/x86_64/iso/) directly.
  8.  
  9. ## Dependencies
  10. `sudo pacman -S archiso git`
  11.  
  12. ## Build your ISO
  13. ```
  14. git clone https://git.pwoss.org/server/iso.git
  15. cd /path/to/repo/ISO/
  16. mkarchiso -v .
  17. ```
  18. > **_NOTE:_**
  19. It is recommended to perform all the following steps as the root user with the umask set to `0022`. If not, it is very likely that the live environment will have wrong file permissions.
  20. > **_NOTE 2:_**
  21. Change `profiledef.sh` to your needs.
  22.  
  23. ## General options
  24. Check `mkarchiso -h`.
  25.  
  26. # PwOSS - ISO
  27. ## SSH
  28. Check the given ip address of your router for `archiso`.
  29. Or nmap ...:
  30. `nmap -sn 192.168.1.0/24`
  31. Live ISO root user password is `pwoss`.
  32.  
  33. ## Necessary modifications
  34. Boot into your Live ISO and change the script __before__ running it!
  35. `nano pwoss-server.sh`
  36. You NEED to change:
  37. 1. `QDISKS="1" # Select the number "1" OR "2". If you have more than 2 hard drives, select 2.`
  38. 2. `ENCRYPTION="YES" # Select "YES" OR "NO" whether you want encryption or not.`
  39. That's the absolute minimum you have to change. Of course you can also change the passwords etc.. But stay between the 2 lines!
  40. > `############################# Change only between the 2 lines`
  41.  
  42. ### HDD or SSD
  43. If you are installing Arch on a HDD hard disk instead of an SSD hard disk, you must delete `root_trim=yes` from grub.
  44. With Encryption:
  45. `nano etc/default/grub-luks`
  46. > `GRUB_CMDLINE_LINUX="cryptdevice=/dev/sda2:root root=/dev/vg0/root resume=/dev/vg0/swap root_trim=yes"`
  47. Without Encryption:
  48. `nano etc/default/grub`
  49. > `GRUB_CMDLINE_LINUX="root_trim=yes"`
  50.  
  51. ## Packages
  52. You can easily add or delete your own packages. Do __NOT__ delete from package `base` to `$MICROCODE` (inlcuding $MICROCODE).
  53.  
  54. ## Usage
  55. ```
  56. pwoss <[options]> -u [<username>]
  57. pwoss <[options]> --username=[<username>]
  58. Options:
  59. -h --help show this message
  60. -u --username set username e.g. $USERNAME
  61. -p --password set user password e.g. $PASSWORD
  62. -r --root-password set root password e.g. $PASSWORDROOT
  63. -e --encryption set encryption e.g. $ENCRYPTION
  64. -cr --crypt-root set root password e.g. $CRYPTPWDROOT
  65. -ch --crypt-home set home password e.g. $CRYPTPWDHOME
  66. -t --timezone set timezine e.g. $TIMEZONE
  67. -q --quantity-disks set numbers of hd e.g. $QDISKS
  68. -d --disk set install disk e.g. $HARDDISK
  69. -d2 --disk2 set home disk e.g. $HARDDISK2
  70. ```
  71. &nbsp;
  72. ## Install on Arch ISO
  73. Boot into any Arch Linux ISO and type the following:
  74. ```
  75. pacman -Sy git
  76. git clone https://git.pwoss.org/server/iso.git
  77. cd ISO/airootfs/
  78. ./pwoss-server.sh
  79. ```
  80. &nbsp;
  81. # Requirements
  82. ## Hardware
  83. ### Minimal system
  84. - 512 megabyte (MB) of memory (RAM)
  85. - 13 gigabytes (GB) of hard disk space
  86. - A one gigahertz (GHz) processor
  87. - A broadband internet connection
  88. - x86_64-compatible machine
  89. &nbsp;
  90. ### Recommended system
  91. - 2 gigabyte (GB) of memory (RAM)
  92. - 18 gigabytes (GB) of hard disk space
  93. - A 2 gigahertz (GHz) processor
  94. - A broadband internet connection
  95. - x86_64-compatible machine
  96. &nbsp;
  97. ### System architecture
  98. The following items are also recommended:
  99. - A reliable 1GB (or greater) USB stick
  100. 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.
  101. &nbsp;
  102. ## Software
  103. ### (Optional) Etcher
  104. Download Etcher to flash the ISO
  105. - [Etcher](https://www.balena.io/etcher/)
  106. &nbsp;
  107. # How To
  108. ## BIOS
  109. You have to align the boot-start to your USB-Stick.
  110. Depending on your motherboard, you must press the __"esc"__ or __"f2"__ or __"f12"__ or __"end"__ key immediately after the PC starts.
  111. > Check your motherboard/computer manual if no button works or ask us.
  112. &nbsp;
  113. __Go to:__
  114. 1. Boot
  115. 2. BOOT DEVICE PRIORITY (or similar)
  116. &nbsp;
  117. Put the USB at the first place (with F5 and F6). Hit the button _esc_ until _save changes and reset_. Hit __enter__ and __yes__.
  118. Reboot and choose Start: Boot Arch Linux (x86_64)
  119. (After installing your operating system, you need to change back your BIOS settings)
  120. &nbsp;
  121. ## Flashing the ISO file
  122. ```
  123. lsblk
  124. ```
  125. > Note:
  126. > Check _of=/dev/sdX_, if it's really your USB Stick!!!
  127. ```
  128. sudo dd bs=4M if=~/Downloads/pwoss-server-*.iso of=/dev/sdX status=progress
  129. ```
  130. > You can also use [Etcher](https://www.balena.io/etcher/) if you prefer a graphical user interface (GUI).
  131. &nbsp;
  132. &nbsp;
  133. ## License
  134. [GNU GENERAL PUBLIC LICENSE Version 2](https://git.pwoss.org/Server/ISO/src/branch/master/LICENSE)