alpine/alpine-wiki
1
0
Fork 0
mirror of https://codeberg.org/alpine/alpine-wiki.git synced 2023-08-25 13:53:16 +02:00
Code Issues Projects Releases Wiki Activity

newbie - started the category with requirementes and install first pages

Browse Source 
* provide a first case.. disk to computer with fresh install only alpine
* provide main readme with principal sections and guides
This commit is contained in:
mckaygerhard 2022-08-01 21:32:11 +00:00
parent 8a3fc2135c
commit 4067617f97
6 changed files with 490 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
alpine/contribution.md
View File

@ -18,7 +18,8 @@ All contributors are expected to abide by our [Rules of Conduct](rules-of-conduc
#### Contributing Guidelines #### Contributing Guidelines
Thanks for your interest in contributing to the project! Those are the **areas or ways you can contribute**: Thanks for your interest in contributing to the project! Those are the
**areas or ways you can contribute**:
- Help to improve and redact into the wiki: - Help to improve and redact into the wiki:
- [How to join and fill a suggestion](#how-to-join-and-fill-a-suggestion) - [How to join and fill a suggestion](#how-to-join-and-fill-a-suggestion)
@ -27,7 +28,8 @@ Thanks for your interest in contributing to the project! Those are the **areas o
- [How to join and apply for bug issue handler](#how-to-join-and-apply-for-bug-issue-handler) - [How to join and apply for bug issue handler](#how-to-join-and-apply-for-bug-issue-handler)
- [How to join and apply for repo sync manager](#how-to-join-and-apply-for-repo-sync-manager) - [How to join and apply for repo sync manager](#how-to-join-and-apply-for-repo-sync-manager)
Each of ***those areas or ways have already alternative ways to do the same**, cos obviously will need minimal requirements already explained in each section. Each of ***those areas or ways have already alternative ways to do the same**,
cos obviously will need minimal requirements already explained in each section.
## How to join and fill a suggestion ## How to join and fill a suggestion

301
newbie/alpine-newbie-install.md Normal file
View File

@ -0,0 +1,301 @@
Alpine newbies install
======================
**Alpine Linux can be installed via many ways**, the most common ones
are listed here, for more information see last section of this document.
- **Computer device** like PC, laptop, or Raspberry, are forms or a
name for machines that uses the software named "Operating System"
like Alpine Linux, the target of a "install process" to property put
the Alpine system.
- **Image file** means it is a type of file that is downloaded and
*burned to a CD/DVD* or *dumped to a USB* with popular programs
(such as Nero, CloneCD, Brasero), although in the modern era it's
a deprecated way due nes kind of devices (Raspberri's, Phone's).
- **Boot** or **[Booting](alpine-bios-uefi-info.md)** means "Boot"
(started from a media source) a "image" recorded on DVD/CD or USB from
the disc drive or from a USB port respectively, the computer boots
this device and loads the Alpine operating system. Today that means
involved with [BIOS and UEFI](alpine-bios-uefi-info.md) systems.
**[Setup\_modes of Alpine
operation](Alpine_setup_scripts#Setup_modes "wikilink")**: Alpine Linux
is designed to run from RAM directly, which means the download image is
already a fully installed, but a minimally configured system. Review the
**[Setup\_modes of Alpine
operation](Alpine_setup_scripts#Setup_modes "wikilink")** for permanent
installation options on most devices.
## Additional Details
## Requirements
Alpine Linux has low system requirements. Nowadays almost hardware is
supported, More requirements documentation can be found on the
[Requirements](alpine-requirements.md) wiki page:
### Memory
- At least 128 MB of RAM for a server without a GUI.
- At least 1.6 GB for graphical desktop
- At least 4 GB for heavy Firefox or Chromium usage\!
More documentation is available on the [Memory requirements
section](Requirements#Memory "wikilink") wiki page.
### Storage
- At least 1 GB storage device for a server without a GUI
- At least 10 GB for graphical desktop, or 80 GB overall
More documentation regarding requirements is available on the [Storage
requirements section](Requirements#Space "wikilink") wiki page
### GPU
The majority of GPUs are supported, but for advanced features, 3D
acceleration is managed by the MESA project:
- Intel: mostly any Intel with one exception, intel i810/i815 will
lack features because of its 4Mb memory, Mesa and Linux have dropped
their support.
- ATI/AMD: Only Radeon series with the exception of the last two years
with respect to the Alpine release, Rage r128/match64 series has
limited support.
- Nvidia: Limited. Only a few are completly supported. Not all
features are enabled.
- Matrox: Not all features are supported. Just because they are
shipped on most servers.
- Sis: Limited features are supported. Code not updated on Xorg and
Linux kernel.
- Via: Limited features are supported. Openchrome code not updated on
Xorg and Linux kernel.
More documentation available on the [Peripheral requirements
section](Requirements#Peripherals "wikilink") wiki page.
# Ways to install Alpine into machines listed by user cases
We have here many ways listed how you can put Alpine Linux in your
computer device, **PLEASE CHOOSE A USE CASE MOST CLOSE TO YOUR SETUP:**
## by booting a source downloaded file ISO on USB or CD/DVD/BR
1. [Alpine Install: from a disc to a virtualbox machine single
only](Alpine_Install:_from_a_disc_to_a_virtualbox_machine_single_only "wikilink"),
install Alpine into VirtualBox virtual machine, use if you have a
**VirtualBox virtual machine and only want to test it out**
2. [Alpine Install: from a disc to a any computer single only
boot](Alpine_Install:_from_a_disc_to_a_any_computer_single_only_boot "wikilink"),
install Alpine into a real modern machine by burning a disc that
will boot if you have
**UEFI or BIOS hardware and will be installing Alpine via a CD/DVD
drive**.
1. [Alpine Install: from a usb to a any computer single only
boot](Alpine_Install:_from_a_usb_to_a_any_computer_single_only_boot "wikilink"),
install Alpine into real modern machine by creating a USB drive unit
that will boot if you have **UEFI or BIOS hardware and will be
installing Alpine via a USB drive**.
2. [Alpine Install: from a usb to any computer dual boot linux
Debian](Alpine_Install:_from_a_usb_to_any_computer_dual_boot_linux_Debian "wikilink"),
install Alpine into most machines by creating a USB drive unit that
will boot if you have **common hardware and want another Linux
distro as your main OS via USB boot**.
3. [Alpine Install: from a usb to any computer dual boot linux
Alpine](Alpine_Install:_from_a_usb_to_any_computer_dual_boot_linux_Alpine "wikilink"),
install Alpine into most machines by creating a USB drive unit that
will boot if you have **common hardware and want Alpine Linux as
your main OS via USB boot**.
4. [Alpine Install: from a disc to a old computer single only
boot](Alpine_Install:_from_a_disc_to_a_old_computer_single_only_boot "wikilink"),
(special case for very very old PC or laptop hardware) by burning a
disc that will boot if you have **BIOS only hardware and will be
installing Alpine on it via CD/DVD drive**.
5. [Alpine Install: from a disc to PC Engines
APU](Alpine_Install:_from_a_disc_to_PC_Engines_APU "wikilink"): to
install Alpine onto a second generation PC Engines APU system.
Tested with an apu2d4 using latest alpine.
## by using from linux already started to new partition
1. [Alpine Install: from alpine mirror to a new computer by
chroot](Alpine_Install:_from_alpine_mirror_to_a_new_computer_by_chroot "wikilink"),
install Alpine on a real (i.e. not virtual) modern machine directly
using the Alpine mirror sources **if you will be using Alpine inside
another Linux installation via chroot**.
2. [Alpine Install: from alpine mirror to an external disc by
chroot](Alpine_Install:_from_alpine_mirror_to_an_external_disc_by_chroot "wikilink"),
install Alpine on a real (i.e. not virtual) modern machine directly
using the Alpine mirror sources **if you extracted the disc for use
with an existing instance of Linux**.
3. [Alpine Install: from a iso to a virtualbox machine with external
disc](Alpine_Install:_from_a_iso_to_a_virtualbox_machine_with_external_disc "wikilink"),
install Alpine on a VirtualBox external disc machine. Use if you
have an **older computer that doesn't boot, but need to extract the
disc to prepare it for use**.
## by booting through network install media
1. [Alpine Install: from a tarball to a bootable ARM
device](Alpine_Install:_from_a_tarball_to_a_bootable_ARM_device "wikilink"),
install Alpine on an ARM based device. Use if you have a **ARM based
network capable install device**.
2. [Alpine on ARM](Alpine_on_ARM "wikilink") for those who need to dump
to ARM based hardware
## by booting from external devices
If the computer does not automatically boot from the desired device, one
needs to bring up the boot menu selection for choosing the media to boot
from. Depending on the computer the menu may be accessed by quickly
pressing pressing a key repeatedly when booting starts. Sometimes you
need to press the button before starting the computer and hold it down
during bootup. Typical keys are: \`F9\`-\`F12\`, sometimes \`F7\` or
\`F8\`. If these don't bring up the boot menu, it may be necessary to
enter the BIOS configuration and adjust the boot settings. Typical keys
are: \`Del\` \`F1\` \`F2\` \`F6\` or \`Esc.\`
- - [Alpine Install: from a disc to PC Engines
APU](Alpine_Install:_from_a_disc_to_PC_Engines_APU "wikilink"):
to install Alpine into second generation PC Engines APU systems.
Tested with an apu2d4 using latest Alpine.
- [Bootstrapping Alpine on PC Engines
ALIX.3](Bootstrapping_Alpine_on_PC_Engines_ALIX.3 "wikilink")
- [Alpine on ARM](Alpine_on_ARM "wikilink") fisrt main reference
to any ARM device
# Ways to install Alpine listed by architectures
## x86\_64 x86\_32 x86
The all popular 32 bit intel (i386 pc 32bit) and x86\_64 (i686 pc 64bit
and amd64)compatible (both)
- - [Alpine Install: from a disc to a virtualbox machine single
only](Alpine_Install:_from_a_disc_to_a_virtualbox_machine_single_only "wikilink"),
install Alpine into VirtualBox virtual machine, use if you have
a **VirtualBox virtual machine and only wants to take a shoot
into it**.
- [Alpine Install: from a disc to a any computer single only
boot](Alpine_Install:_from_a_disc_to_a_any_computer_single_only_boot "wikilink"),
install Alpine into a real modern machine by burning a disc that
will boot if you have a **UEFI or BIOS hardware and will be only
Alpine into it through CD/DVD drive**.
- [Alpine Install: from a usb to a any computer single only
boot](Alpine_Install:_from_a_usb_to_a_any_computer_single_only_boot "wikilink"),
install Alpine into real modern machine by creating a USB drive
unit that will boot if you have a **UEFI or BIOS hardware and
will be only Alpine into it through USB drive**.
- [Alpine Install: from a usb to any computer dual boot linux
Debian](Alpine_Install:_from_a_usb_to_any_computer_dual_boot_linux_Debian "wikilink"),
install Alpine into most common machine by creating a USB drive
unit that will boot if you have **common hardware and want
another Linux as main OS through USB boot**.
- [Alpine Install: from a usb to any computer dual boot linux
Alpine](Alpine_Install:_from_a_usb_to_any_computer_dual_boot_linux_Alpine "wikilink"),
install Alpine into most common machine by creating a USB drive
unit that will boot if you have **common hardware and want
Alpine Linux as main OS through USB boot**.
- [Alpine Install: from a disc to a old computer single only
boot](Alpine_Install:_from_a_disc_to_a_old_computer_single_only_boot "wikilink"),
especial case for very very older hardware computers PC or
laptops by burning a disc that will boot if you have a **BIOS
only older hardware and will be only Alpine into it through
CD/DVD drive**.
- [Bootstrapping Alpine on PC Engines
ALIX.3](Bootstrapping_Alpine_on_PC_Engines_ALIX.3 "wikilink")
- [Alpine Install: from a disc to PC Engines
APU](Alpine_Install:_from_a_disc_to_PC_Engines_APU "wikilink"):
to install Alpine into second generation PC Engines APU systems,
it were tested with an apu2d4 using alpine lasted.
## ppc64le
For the PowerPC devices with pure little-endian mode, mostly for POWER8
and POWER9
- - [Alpine Install: from a disc to a any computer single only
boot](Alpine_Install:_from_a_disc_to_a_any_computer_single_only_boot "wikilink"),
install Alpine on a real (i.e. ot virtual) modern machine by
burning a disc that will boot if you have **UEFI or BIOS
hardware and will be installing Alpine on it via a CD/DVD
drive**.
- [Alpine Install: from a usb to a any computer single only
boot](Alpine_Install:_from_a_usb_to_a_any_computer_single_only_boot "wikilink"),
install Alpine on real (i.e. ot virtual) modern machine by
creating a USB drive that will boot if you have **UEFI or BIOS
hardware and will be installing Alpine on it via a USB
drive**.
## armhf armv7
ARM based hardware that does not have CD/DVD/BR boot support, only
execution state of the ARMv7 devices machines. Including video game
consoles; the newer ARM hard-float for newer, more powerful, 32-bit as
well as 64-bit devices.
- - [Alpine on ARM](Alpine_on_ARM "wikilink") Main reference for ARM
devices
## aarch64
The 64-bit ARM only execution state of the ARMv8 device machines.
- - [Alpine Install: from a usb to a any computer single only
boot](Alpine_Install:_from_a_usb_to_a_any_computer_single_only_boot "wikilink"),
install Alpine on a real (i.e. not virtual) modern machine by
creating a USB drive unit that will boot if you have **UEFI or
BIOS hardware and will be installing Alpine on it via a USB
drive**.
- [Alpine on ARM](Alpine_on_ARM "wikilink") Main reference for ARM
devices
## s390x
For the Super powered IBM mainframes, especially IBM Z and IBM LinuxONE
servers
- - [Alpine Install: from a disc to a any computer single only
boot](Alpine_Install:_from_a_disc_to_a_any_computer_single_only_boot "wikilink"),
install Alpine on real (i.e.not virtual) modern machine by
burning a disc that will boot if you have **UEFI or BIOS
hardware and will be installing Alpine on it via a CD/DVD
drive**.
- [Alpine Install: from a usb to a any computer single only
boot](Alpine_Install:_from_a_usb_to_a_any_computer_single_only_boot "wikilink"),
install Alpine into real (i.e.not virtual) modern machine by
creating a USB drive unit that will boot if you have **UEFI or
BIOS hardware and will be installing Alpine on it via a USB
drive**.
# Ways to use Alpine Linux without install
1. [Alpine Install: from a usb disc to a machine single
only](Alpine_Install:_from_a_usb_disc_to_a_machine_single_only "wikilink"),
dump Alpine onto a usb/mmc card and live boot it on your machine
without modifying any of your installed files or operating system.
# Documents series
| Previous required | What's next to read |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| [Alpine newbie](Alpine_newbie "wikilink") | [Alpine Install: from a disc to a virtualbox machine single only](Alpine_Install:_from_a_disc_to_a_virtualbox_machine_single_only "wikilink") |
# See Also
1. [Newbie\_Alpine\_Ecosystem](Newbie_Alpine_Ecosystem "wikilink")
2. [Alpine newbie apk packages](Alpine_newbie_apk_packages "wikilink")
3. [Alpine newbie desktops](Alpine_newbie_desktops "wikilink")
4. [Alpine newbie developer](Alpine_newbie_developer "wikilink")
5. [Alpine newbie lammers](Alpine_newbie_lammers "wikilink")
[Category:Newbie](Category:Newbie "wikilink")
[Category:Installation](Category:Installation "wikilink")

36
newbie/alpine-newbie-prepare.md Normal file
View File

@ -0,0 +1,36 @@
.. firs of all.. when you start to learn something you should check your available resources agains the needs ..
## requirements
We are persons, so first of all [we have real life requirements](#real-life-requirements)
and after [we need related requirements](#related-requirements).
You as future contributor or developer must check your resources and adapt those to your situation..
that seems unrelated to learning but ITS VERY IMPORTANT! Why?: well cos in linux and development
you shoul READ A LOT .. and that will waste time from your life.
### Real life requirementes
* **Manners**, you will must have a vocation for reading and analysis.
* **Time**, you will need time, cos you will need to read a lot!
* **Computer**, you should have a pc, or similar, by example most of the people uses the androit phone to handle an internal linux using [termux](termux-pending-file.md)
### Related requirementes
* **Knowledge** you will need a knowed editor, a god knowledge of git as minimal base..
* **Internet**, and minimal bandwitch of internet network.. cos almost today all the development will forced to you to contribute over internet.
* **Unix-like**, you should have some kind of way to interact with a UNIX like operating system, like MAC or Linux.
### About this wiki newbie
This material is a main one, for a more focused tutorial please check
the [../tutorials/](../tutorials/) directory space, that have more focused or maybe simple ways to
reach specific objetives. Of course those **guides or tutorials will assume you already have knowledge**.
On the other hand, **this material (newbie sections) assumes a more general level and helps you to follow the steps more slowly,
in categories and explained steps**.
### About copyright material
Please check our [../alpine/copyright.md](../alpine/copyright.md).

BIN
newbie/install-alpine-alpine-setup-9-setup-disk-3-7-end.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.9 KiB

BIN
newbie/install-alpine-boot-up-live-01.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 22 KiB

149
newbie/install-alpine-single-boot-any-from-disk-to-any-computer.md Normal file
View File

@ -0,0 +1,149 @@
**Overall description:** Alpine Installation from a official disc/iso
burned into DVD/CD to a new computer with [BIOS](alpine-bios-uefi-info.md#bios)
or [UEFI](alpine-bios-uefi-info.md#uefi) and will be single only boot.
**It means:** that any thing in the computer and their storage will be erased to
put Alpine Linux as main system, using a optical disk media as source install
This document will guide you to ***install Alpine into a new empty or
just fresh PC or Laptop hardware computer**, use if you have a [BIOS or UEFI](../alpine/alpine-and-uefi.md)
and only wants Alpine Linux into the target computer. For other ways
of install check the index installation page cases at [Alpine Newbie Install](alpine-newbie-install.md) page
## Terminology
- **[UEFI](alpine-bios-uefi-info.md#uefi) **: it's a new system included
in every new hardware machine laptop or desktops, that will manage
the early boot process as a little operating system, see more in the
[alpine-and-uefi.md](alpine-and-uefi.md) page.
- **New machine**: will be your real machine fresh and ready to
install your new Alpine operating system, with a installed CD/DVD
Rom optical drive where to put the burned downloaded disc media
installation.
- **Source media**: will be the just burned/ disc from the downloaded
iso file of Alpine operating system. Will be put into the optical
drive or named [DVD/CD Rom](https://en.wikipedia.org/wiki/CD-ROM) to
property boot the source disc as media installation.
- **Target media**: will be the storage medium device into the new
computer target where the Alpine files for operating system will be
installed, its one partition from the
[HardDisk](https://en.wikipedia.org/wiki/Hard_disk_drive) of the new
computer.
- **Optical drive**: will be your hardware drive input to put the
burned downloaded iso media with the operating system Alpine to
install as source media; this drive are commonly named [DVD/CD
Rom](https://en.wikipedia.org/wiki/CD-ROM) unit.
## Requirements
- A blank disc (CD blank or DVD blank or BR blank) to just burn/record
the source media file downloaded
- In the new machine we need optical drive as input source media
- In the new machine we need at least 512Mb of RAM, but required 2Gb
of RAM for desktop/graphical applications
- In the new machine we need target media with at least 2G of hard
disk, but required 10G for desktops
- Will need to previously downloaded and burned the Source media ISO
file from <https://alpinelinux.org/downloads/>
Detailed requirements are at [../alpine/requirementes.md](../alpine/requirementes.md)
## Preparing the source medium to install
Download the source medium to install and put into your home documents,
this document will use the DISK IMAGE medium type ( ISO IMG formats)
If the source medium to install download URL will be as following format:
`http://dl-cdn.alpinelinux.org/alpine/v<VERSION>/releases/<ARCH>/alpine-standard-<VERSION>.0-<ARCH>.iso`
where `ARCH` and `VERSION` could be:
- `<ARCH>` will be
- **x86**: the most used i386 32-bit x86 based machines, if your
computer are too older use this only.
- **x86\_64**: the popular AMD64 compatible 64-bit x86 based machines, for
modern computers use this then.
- **s390x**: For the Super powered IBM mainframes, use this for
especially IBM Z and IBM LinuxONE servers then.
- **ppc64le**: For the PowerPC devices with pure little-endian
mode, mostly for POWER8 and POWER9 machines.
- `<VERSION>` could be
- **latest-stable** for a more up to date without taking care of stability
- **3.10** the most recommended for machines between 2016 to 2018 mostly pc's
- **3.14** the most recommended for rasberris and small devices (`x86_64`)
- **3.16** the most recommended for machines from 2017 up to 2022 and servers
Example, so if we will use 3.10 alpine version the correct links to download will be:
- for **x86\_64** a link to download should be:
`http://dl-cdn.alpinelinux.org/alpine/v3.10/releases/x86_64/alpine-standard-3.10.0-x86_64.iso`
- for **ppc64le** a link to download should be:
`http://dl-cdn.alpinelinux.org/alpine/v3.10/releases/ppc64le/alpine-standard-3.10.1-ppc64le.iso`
**Graphical download**: Just point the web browser to that url and the
download of the iso file will start. A file with **.iso** extension
type, with name like `"alpine-standard-3.10.0-x86_64.iso"` (if amd64) or
like `alpine-standard-3.10.1-s390x.iso` (if s390x); will be downloaded
commonly into the Download directory of your home or documents filesystem.
**Command line method**: in unix-like terminal execute (by example to download the 3.10 for 64bit pc):
`wget -c -t8 --no-check-certificate http://dl-cdn.alpinelinux.org/alpine/v3.10/releases/x86_64/alpine-standard-3.10.0-x86_64.iso`,
and where you run the command, in that place/dir will be downloaded the file.
## Burning the source medium to install
After downloading the source media file from [Alpine download page](https://alpinelinux.org/downloads/)
put the blank disc into the input optical drive
named [DVD/CDRom](https://en.wikipedia.org/wiki/CD-ROM) and **open your CD/DVD
recording program, choose to "burn from iso file"** and wait the process
will end.
In detail if you downloaded with **Graphical download** (using a web
browser), the source media file will be into the Download directory. If
you downloaded with **Command line method** your source file probably
will be in your root document home (or just `$HOME` of your Linux
install or MAC install filesystem).
In Linux, assuming the blank disc is in the optical drive, the command
to record/burn the downloaded source media file is :
`$ umount /dev/sr0;cdrecord -v -sao dev=/dev/sr0 alpine-standard-3.10.0-x86_64.iso`
If your blank media is a DVD or BD disc the command will be then :
`$ umount /dev/sr0;growisofs -dvd-compat -Z /dev/sr0=alpine-standard-3.10.0-x86_64.iso`
## Booting the Alpine ISO disc
When the machine start, you must be sure to choose the optical drive
(commonly named CD/DVD Rom drive), so the disc/iso will boot and after a
while a command line shell will show you:
![Installation : setup-alpine : booting process until login prompt](install-alpine-boot-up-live-01.png)
## Runing the setup install
TODO: The steps here are common to all the normal metos of simple install
## Finishing the installation
After all of the scripts in the setup end, a "reboot" will be offered,
just type "reboot" and press enter, remove the boot media and newly
installed system will be booted.
![install-alpine-alpine-setup-9-setup-disk-3-7-end.png](install-alpine-alpine-setup-9-setup-disk-3-7-end.png)
**You cannot see a graphical window system? take it easy** and get calmed down..
in Alpine all are made by the right way.. so **if user need a desktop.. user can (must) install a desktop**
# Documents series
| Previous required | What's next to read |
| ------------------------------------------------- | -------------------------------------------------- |
| [Alpine Newbie Prepare](alpine-newbie-prepare.md) | [Alpine Newbie Configs](alpine-newbie-configs.md) |
# See Also
1. [Alpine Newbie Install](alpine-newbie-install.md)
2. [Alpine newbie Desktop](alpine-newbie-desktop.md)