Alpine Linux - User contributions [en]

Bootstrapping Alpine Linux

2024-12-26T08:30:16Z

Msleaveamix: /* Install */ added that you can choose the version of alpine to bootstrap.

= VPS =
This section is to provide a means to bootstrap Alpine Linux on any VPS.

== Process ==

=== Prepare ===

Download apk binary file for your architecture or boot from an Alpine live ISO.

Hint to download apk :
<pre>wget https://gitlab.alpinelinux.org/api/v4/projects/5/packages/generic/v2.14.6/x86_64/apk.static</pre>

=== Install ===

Assuming your alpine rootfs is mounted in '''/tmp/target''' and you downloaded apk binary (not using the live ISO).

You may want to replace "latest-stable" from the URL by a specific version of Alpine (e.g. v3.20, v3.21).

<code>sudo ./apk.static --arch $(arch) -X http://dl-cdn.alpinelinux.org/alpine/latest-stable/main/ -U --allow-untrusted --root /tmp/target --initdb add alpine-base</code>

* edit /tmp/target/etc/fstab
* edit /tmp/target/etc/inittab
* edit /tmp/target/etc/resolv.conf
* mount proc/sys/dev
<pre>for a in proc sys dev; do mount -o bind /$a /tmp/target/$a; done</pre>
* chroot into your new installation
<pre>chroot /tmp/target /bin/sh</pre>
* setup hostname
<pre>setup-hostname</pre>
* setup network
<pre>setup-interfaces</pre>
* setup repos
<pre>setup-apkrepos -f</pre>
* add a few base packages
<pre>apk update
apk add linux-lts linux-firmware-none acpi mkinitfs</pre>
* add services to boot
<pre>
rc-update add acpid default
rc-update add bootmisc boot
rc-update add crond default
rc-update add devfs sysinit
rc-update add dmesg sysinit
rc-update add hostname boot
rc-update add hwclock boot
rc-update add hwdrivers sysinit
rc-update add killprocs shutdown
rc-update add mdev sysinit
rc-update add modules boot
rc-update add mount-ro shutdown
rc-update add networking boot
rc-update add savecache shutdown
rc-update add seedrng boot
rc-update add swap boot
</pre>

=== Bootloader ===

=== Notes ===
If you have bootstrapped Alpine Linux from an existing system in a different partition and intend to boot into it, you should always include the root filesystem type (rootfstype) in the kernel parameter (bootloader option), since by default kernel does not automatically load any filesystem modules for root partition, unless specified. That way mount will not complain about being unable to mount root partition on /sysroot.

Example bootloader option:

<code>root=UUID=AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE rw rootfstype=ext4 vfat</code>

== References ==
* [https://www.linode.com/docs/tools-reference/custom-kernels-distros/running-a-custom-linux-distro-on-a-linode-vps Running a Custom Linux Distribution on a Linode]
* [https://www.linode.com/docs/tools-reference/custom-kernels-distros/run-a-custom-compiled-kernel-with-pvgrub Run a Custom Compiled Kernel with PV-GRUB]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Install Alpine on Amazon EC2]]
* [[Alpine setup scripts]]
* [https://serverfault.com/questions/98950/how-do-i-chain-boot-from-grub-to-syslinux How do I chain boot from grub to syslinux?]
* [https://web.archive.org/web/20151008232205/http://uggedal.com/journal/alpine-linux-on-linode/ Alpine Linux on Linode]
* [[Installing Alpine Linux in a chroot]]

[[Category:Installation]]
[[Category:Virtualization]]

Bootstrapping Alpine Linux

2024-12-26T08:28:23Z

Msleaveamix: /* Install */ apk.static is downloaded directly in the current directory, add specification that you're not using the live ISO to bootstrap

= VPS =
This section is to provide a means to bootstrap Alpine Linux on any VPS.

== Process ==

=== Prepare ===

Download apk binary file for your architecture or boot from an Alpine live ISO.

Hint to download apk :
<pre>wget https://gitlab.alpinelinux.org/api/v4/projects/5/packages/generic/v2.14.6/x86_64/apk.static</pre>

=== Install ===

Assuming your alpine rootfs is mounted in '''/tmp/target''' and you downloaded apk binary (not using the live ISO).

<code>sudo ./apk.static --arch $(arch) -X http://dl-cdn.alpinelinux.org/alpine/latest-stable/main/ -U --allow-untrusted --root /tmp/target --initdb add alpine-base</code>

* edit /tmp/target/etc/fstab
* edit /tmp/target/etc/inittab
* edit /tmp/target/etc/resolv.conf
* mount proc/sys/dev
<pre>for a in proc sys dev; do mount -o bind /$a /tmp/target/$a; done</pre>
* chroot into your new installation
<pre>chroot /tmp/target /bin/sh</pre>
* setup hostname
<pre>setup-hostname</pre>
* setup network
<pre>setup-interfaces</pre>
* setup repos
<pre>setup-apkrepos -f</pre>
* add a few base packages
<pre>apk update
apk add linux-lts linux-firmware-none acpi mkinitfs</pre>
* add services to boot
<pre>
rc-update add acpid default
rc-update add bootmisc boot
rc-update add crond default
rc-update add devfs sysinit
rc-update add dmesg sysinit
rc-update add hostname boot
rc-update add hwclock boot
rc-update add hwdrivers sysinit
rc-update add killprocs shutdown
rc-update add mdev sysinit
rc-update add modules boot
rc-update add mount-ro shutdown
rc-update add networking boot
rc-update add savecache shutdown
rc-update add seedrng boot
rc-update add swap boot
</pre>

=== Bootloader ===

=== Notes ===
If you have bootstrapped Alpine Linux from an existing system in a different partition and intend to boot into it, you should always include the root filesystem type (rootfstype) in the kernel parameter (bootloader option), since by default kernel does not automatically load any filesystem modules for root partition, unless specified. That way mount will not complain about being unable to mount root partition on /sysroot.

Example bootloader option:

<code>root=UUID=AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE rw rootfstype=ext4 vfat</code>

== References ==
* [https://www.linode.com/docs/tools-reference/custom-kernels-distros/running-a-custom-linux-distro-on-a-linode-vps Running a Custom Linux Distribution on a Linode]
* [https://www.linode.com/docs/tools-reference/custom-kernels-distros/run-a-custom-compiled-kernel-with-pvgrub Run a Custom Compiled Kernel with PV-GRUB]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Install Alpine on Amazon EC2]]
* [[Alpine setup scripts]]
* [https://serverfault.com/questions/98950/how-do-i-chain-boot-from-grub-to-syslinux How do I chain boot from grub to syslinux?]
* [https://web.archive.org/web/20151008232205/http://uggedal.com/journal/alpine-linux-on-linode/ Alpine Linux on Linode]
* [[Installing Alpine Linux in a chroot]]

[[Category:Installation]]
[[Category:Virtualization]]

Bootstrapping Alpine Linux

2024-12-26T08:25:25Z

Msleaveamix: removed useless unpacking, update apk-tool-static to apk binary, update URL, add option to "boot into a live ISO"

= VPS =
This section is to provide a means to bootstrap Alpine Linux on any VPS.

== Process ==

=== Prepare ===

Download apk binary file for your architecture or boot from an Alpine live ISO.

Hint to download apk :
<pre>wget https://gitlab.alpinelinux.org/api/v4/projects/5/packages/generic/v2.14.6/x86_64/apk.static</pre>

=== Install ===

Assuming your alpine rootfs is mounted in '''/tmp/target'''

<code>sudo ./sbin/apk.static --arch $(arch) -X http://dl-cdn.alpinelinux.org/alpine/latest-stable/main/ -U --allow-untrusted --root /tmp/target --initdb add alpine-base</code>

* edit /tmp/target/etc/fstab
* edit /tmp/target/etc/inittab
* edit /tmp/target/etc/resolv.conf
* mount proc/sys/dev
<pre>for a in proc sys dev; do mount -o bind /$a /tmp/target/$a; done</pre>
* chroot into your new installation
<pre>chroot /tmp/target /bin/sh</pre>
* setup hostname
<pre>setup-hostname</pre>
* setup network
<pre>setup-interfaces</pre>
* setup repos
<pre>setup-apkrepos -f</pre>
* add a few base packages
<pre>apk update
apk add linux-lts linux-firmware-none acpi mkinitfs</pre>
* add services to boot
<pre>
rc-update add acpid default
rc-update add bootmisc boot
rc-update add crond default
rc-update add devfs sysinit
rc-update add dmesg sysinit
rc-update add hostname boot
rc-update add hwclock boot
rc-update add hwdrivers sysinit
rc-update add killprocs shutdown
rc-update add mdev sysinit
rc-update add modules boot
rc-update add mount-ro shutdown
rc-update add networking boot
rc-update add savecache shutdown
rc-update add seedrng boot
rc-update add swap boot
</pre>

=== Bootloader ===

=== Notes ===
If you have bootstrapped Alpine Linux from an existing system in a different partition and intend to boot into it, you should always include the root filesystem type (rootfstype) in the kernel parameter (bootloader option), since by default kernel does not automatically load any filesystem modules for root partition, unless specified. That way mount will not complain about being unable to mount root partition on /sysroot.

Example bootloader option:

<code>root=UUID=AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE rw rootfstype=ext4 vfat</code>

== References ==
* [https://www.linode.com/docs/tools-reference/custom-kernels-distros/running-a-custom-linux-distro-on-a-linode-vps Running a Custom Linux Distribution on a Linode]
* [https://www.linode.com/docs/tools-reference/custom-kernels-distros/run-a-custom-compiled-kernel-with-pvgrub Run a Custom Compiled Kernel with PV-GRUB]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Install Alpine on Amazon EC2]]
* [[Alpine setup scripts]]
* [https://serverfault.com/questions/98950/how-do-i-chain-boot-from-grub-to-syslinux How do I chain boot from grub to syslinux?]
* [https://web.archive.org/web/20151008232205/http://uggedal.com/journal/alpine-linux-on-linode/ Alpine Linux on Linode]
* [[Installing Alpine Linux in a chroot]]

[[Category:Installation]]
[[Category:Virtualization]]

Talk:ISP Mail Server 3.x HowTo

2021-09-07T12:13:19Z

Msleaveamix:

== issues, e.g. php ==

well the 1.st line

* apk add lighttpd php php-cgi php-pgsql php-imap php-mbstring

already breaks. let's see...
--[[User:Yy22yy|Yy22yy]] ([[User talk:Yy22yy|talk]]) 11:21, 10 July 2019 (UTC)

== Spam setup ==

<blockquote>
This document describes installation process for the Alpine Linux 3.x platform. The goal of this document is to describe how to set up postfix, dovecot, clamav, dspam, roundecube, and postfixadmin for a full-featured "ISP" level mail server
</blockquote>

In the description we say that it includes dspam setup instructions. This is not in the content of the article.

We should probably include the instructions to setup a spam filter, it being dspam or spamassassin.

== ClamAV error ==

<blockquote>
* Install clamav and clamsmtp:
apk add acf-clamav clamsmtp
</blockquote>

Why installing acf-clamav instead of clamav?

Talk:ISP Mail Server 3.x HowTo

2021-09-07T12:10:45Z

Msleaveamix: /* ClamAV error */ new section

== issues, e.g. php ==

well the 1.st line

* apk add lighttpd php php-cgi php-pgsql php-imap php-mbstring

already breaks. let's see...
--[[User:Yy22yy|Yy22yy]] ([[User talk:Yy22yy|talk]]) 11:21, 10 July 2019 (UTC)

== Spam setup ==

> This document describes installation process for the Alpine Linux 3.x platform. The goal of this document is to describe how to set up postfix, dovecot, clamav, dspam, roundecube, and postfixadmin for a full-featured "ISP" level mail server

In the description we say that it includes dspam setup instructions. This is not in the content of the article.

We should probably include the instructions to setup a spam filter, it being dspam or spamassassin.

== ClamAV error ==

> * Install clamav and clamsmtp:
> apk add acf-clamav clamsmtp

Why installing acf-clamav instead of clamav?

Talk:ISP Mail Server 3.x HowTo

2021-09-07T11:00:50Z

Msleaveamix: /* Spam setup */ new section

== issues, e.g. php ==

well the 1.st line

* apk add lighttpd php php-cgi php-pgsql php-imap php-mbstring

already breaks. let's see...
--[[User:Yy22yy|Yy22yy]] ([[User talk:Yy22yy|talk]]) 11:21, 10 July 2019 (UTC)

== Spam setup ==

> This document describes installation process for the Alpine Linux 3.x platform. The goal of this document is to describe how to set up postfix, dovecot, clamav, dspam, roundecube, and postfixadmin for a full-featured "ISP" level mail server

In the description we say that it includes dspam setup instructions. This is not in the content of the article.

We should probably include the instructions to setup a spam filter, it being dspam or spamassassin.