Alpine Linux - User contributions [en]

Template:Copying Alpine to Flash

2012-06-19T08:36:30Z

Jyke: setup-bootable expects a formatted partition. added Note to say so

=== Boot Alpine Linux CD-ROM ===
# Insert the Alpine Linux CD-ROM into a computer.
# Boot the computer from the Alpine Linux CD-ROM.
#* This step may require changes to the BIOS settings to select booting from CD.
# Login with the username ''root''. No password is needed.

=== Determine the Device Name of the {{{1|Flash Medium}}} ===
Determine the name your computer uses for your {{{1|flash medium}}}. The following step is one way to do this.
# After inserting the {{{1|flash medium}}}, run the command:
#* {{Cmd|dmesg}}
#* At the end of this command you should see the name of your {{{1|flash medium}}}, likely starting with "sd". (For example: "sda").
#* The remainder of this document will assume that your {{{1|flash medium}}} is called /dev/sda

{{Warning|Be very careful about this. You do not want to mistakenly wipe your hard drive if it's on /dev/sda}}

=== Format {{{1|Flash Medium}}} ===
Run fdisk (replacing sda with your {{{1|flash medium}}} name):
{{Cmd|fdisk /dev/sda}}

# (''Optional'') - Create new partition table with one FAT32 partition
#* '''d''' Delete all partitions (this may take a few steps)
#* '''n''' Create a new partition
#* '''p''' A primary partition
#* '''1''' Partition number 1
#** Use defaults for first and last cylinder (just press [Enter] twice).
#* '''t''' Change partition type
#* '''c''' Type: Win95 FAT32 (LBA)
#Verify that the primary partition is bootable
#* '''p''' Print list of partitions
#* If there is no '*' next to the first partition, follow the next steps:
#** '''a''' <big>Make the partition bootable (set boot flag)</big>
#** '''1''' Partition number 1
#'''w''' Write your changes to the device

=== Add Alpine Linux to the {{{1|Flash Medium}}} ===
To boot from your {{{1|flash medium}}} you need to copy the contents of the CDROM to the {{{1|flash medium}}} and make it bootable. Those two operations can be automated with the [[setup-bootable]] tool or can be done manually.

{{Note|If the following commands fail due to 'No such file or directory', you may have to remove and reinsert the {{{1|flash medium}}}, or even reboot, to get /dev/sda1 to appear}}

==== Automated ====
{{Tip|If using Alpine Linux 1.10.4 or newer, you can use this section to complete the install. Otherwise, follow the Manual steps below.}}
# Run the [[setup-bootable]] script to add Alpine Linux to the {{{1|flash medium}}} and make it bootable (replacing sda with your {{{1|flash medium}}} name):
#: {{Cmd|setup-bootable /media/cdrom /dev/sda1}}
{{Note|The target partition has to be formatted. Use the <code>mkdosfs</code> command from the Manual steps below if needed.}}
{{Warning|If you are installing to a USB Stick, the <code>setup-bootable</code> script will not use <code>usbdisk</code> in the {{Path|syslinux.cfg}} file. You should modify it to say <code>usbdisk</code> as [[#Wrong_Device_Name|described below]], or you will face possible problems booting and definite problems with the package cache.}}

==== Manual ====
# (''Optional'') - If you created a new partition above, format the {{{1|flash medium}}} with a FAT32 filesystem (replacing sda with your {{{1|flash medium}}} name):
#: {{Cmd|apk add dosfstools<BR>mkdosfs -F32 /dev/sda1}}
# Install syslinux and MBR (replacing sda with your {{{1|flash medium}}} name):
#: {{Cmd|{{{|apk add syslinux<BR>dd if=/usr/share/syslinux/mbr.bin of=/dev/sda}}}<BR>syslinux /dev/sda1}}
#Copy the files to the {{{1|flash medium}}} (replacing sda with your {{{1|flash medium}}} name):
#: {{Cmd|<nowiki>mkdir -p /media/sda1
mount -t vfat /dev/sda1 /media/sda1
cd /media/cdrom
cp -a .alpine-release * /media/sda1/
umount /media/sda1</nowiki>}}

== Troubleshooting ==
=== Wrong Device Name ===
If you cannot boot from the {{{1|flash medium}}} and you see something like:
Mounting boot media failed.
initramfs emergency recovery shell launched. Type 'exit' to continue boot
then it is likely that the device name in syslinux.cfg is wrong. You should replace the device name in the syslinux.cfg line:
append initrd=/boot/grsec.gz alpine_dev='''usbdisk''':vfat modules=loop,cramfs,sd-mod,usb-storage quiet
with the proper device name.
* For boot from USB, the device name should be 'usbdisk' (as shown above)
* For other options, you can run '''cat /proc/partitions''' to see the available disks (i.e. 'sda' or 'sdb')

=== Non-FAT32 Filesystems ===
When your {{{1|flash medium}}} is formatted with a filesystem other than FAT32, you might have to specify the necessary filesystem modules in the boot parameters.

To do so, mount the {{{1|flash medium}}} and change the syslinux.cfg file line from
append initrd=/boot/grsec.gz alpine_dev=usbdisk:vfat modules=loop,cramfs,sd-mod,usb-storage quiet
to
append initrd=/boot/grsec.gz alpine_dev=usbdisk:vfat modules=loop,cramfs,sd-mod,usb-storage''',ext3''' quiet
in the case of an ext3 formatted partition. A similar procedure might apply to other filesystems (if they are supported by syslinux and the Alpine Linux kernel).

File:Alpine-vbox-1strun-1.png

2010-05-19T02:20:40Z

Jyke:

File:Alpine-vbox-5.png

2010-05-19T02:10:05Z

Jyke:

File:Alpine-vbox-4.png

2010-05-19T02:09:49Z

Jyke:

File:Alpine-vbox-3.png

2010-05-19T02:09:31Z

Jyke:

File:Alpine-vbox-2.png

2010-05-19T02:09:05Z

Jyke:

File:Alpine-vbox-1.png

2010-05-19T02:02:15Z

Jyke:

Tutorials and Howtos

2010-05-19T01:47:21Z

Jyke: added virtualbox howto

[[Image:package_edutainment.svg|left|link=]]
{{TOC right}}'''Welcome to Tutorials and Howtos, a place of basic and advanced configuration tasks for your Alpine Linux.'''
The tutorials are hands-on and the reader is expected to try and achieve the goals described in each step, possibly with the help of a good examples. The output in one step is the starting point for the following step.<br/>
Howtos are smaller articles explaining how to perform a particular task with Alpine Linux. We encourage people to send in both complete articles as well as requesting topics to be covered. If you think you have the skills and knowledge to write an Alpine Linux related article please do so on this Wiki. If you want to request a topic, please add your request in this page [[Talk:Tutorials_and_Howtos&action=edit|Discussion]].

== Installation ==
* [[Bootstrapping Alpine on Soekris net4xxx]]
* [[Bootstrapping Alpine on PC Engines ALIX.3]]
* [[Setting up a software raid1 array]]
* [[Setting up Logical Volumes with LVM]]
* [[Setting up a /var partition on software IDE raid1]]
* [[Native Harddisk Install]]
* [[Installing XUbuntu using Alpine boot floppy]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Booting Alpine on an HP ML350 G6]]
* [[Installing XFCE as a VirtualBox guest]]
* [[Enable Serial Console on Boot]]
* [[How to enable APK caching]]
* [[Install Alpine on VirtualBox]]

== Networking ==
* [[Setting up a OpenVPN-server with Alpine]]
* [[Setting up traffic monitoring using rrdtool (and snmp)]]
* [[Setting up Zaptel/Asterisk on Alpine]]
* [[Using HSDPA modem]]
* [[Using Alpine on Windows domain with IPSEC isolation]]
* [[Using Racoon for Remote Sites]]
* [[High Performance and Fault Tolerant Routing with Alpine Linux]]

== Misc ==
* [[Setting up lm_sensors]]
* [[Setting up Satellite Internet Connection]]
* [[Setting up Streaming an Asterisk Channel]]
* [[Formatting HD/Floppy/Other]]
* [[Setting up Transmission (bittorrent) with Clutch WebUI]]
* [[Hosting services on Alpine]] ''(This applies to hosting mail, webservices and other services)''
** [[Setting up postfix with virtual domains]]
** [[Protecting your email server with Alpine]]
** [[Hosting Web/Email services on Alpine]]
** [[Setting up trac wiki]]
* [[Running Alpinelinux As a QEMU networked Guest ]]
* [[Screen on console]]
* [[Using espeak on Alpine Linux]]
* [[Generating SSL certs with ACF]]
* [[Setting up a ssh-server]]
* [[Changing passwords]]
* [[Multiple Instances of Services]]
* [[Setting up NRPE daemon]]
* [[IPTV How To]]
* [[ISP Mail Server HowTo]] ''(Postfix+PostfixAdmin+DoveCot+Roundcube+ClamAV+Spamd - A full-serivce ISP mail server)''
* [[XFCE Setup]]
* [[Freepbx on AlpineLinux]]

== iSCSI ==
* [[iSCSI Target and Initiator Configuration]]
* [[iSCSI Raid and Clustered File Systems]]

== Vserver ==
* [[Setting up a basic vserver]]