Post installation: Difference between revisions

From Alpine Linux
(blanked page as all content moved and added REDIRECT)
Tag: New redirect
 
(59 intermediate revisions by 12 users not shown)
Line 1: Line 1:
{{Draft|This page "should" contain accurate and up to date information but is a work in progess}}
#REDIRECT [[Installation#Post-Installation]]
 
== General Notes ==
 
* When '''#''' is displayed before a command that means the command needs to be run with root privileges,
 
* Anything in < > is likely just a placeholder that you need to replace (example: <editor> file.txt)
 
* Some information in here might be a repeat of information in other wiki pages, if you find a section where that is the case please add a link to the original wiki page.
 
<br>
 
== Network setup ==
 
==== Wi-Fi ====
 
* [[Wi-Fi]]
* [[NetworkManager]]
 
==== Ethernet (Wired) ====
 
{{Expand|Documentation on Ethernet (Wired) internet setup needs to be created/expanded, maybe information from other wiki's/docs might be helpful?}}
 
* [[Ethernet|Ethernet]]
* [[NetworkManager]]
 
<br>
 
== Creating a new user account ==
 
After installing Alpine by default you only get a root account. You will probably want to create an account that is not root,
 
{{cmd|# adduser <YourUsername>}}
replace <YourUsername> with the username of your choice
 
<br>
 
You will probably want to install '''doas''' so you can allow <YourUsername> to use root privileges
{{cmd|# apk add doas}}
 
<br>
 
If you want your user to be able to use root privileges add them to the Wheel group
{{cmd|# adduser <YourUsername> wheel}}
 
<br>
 
Allow members of the '''Wheel''' group to use root privileges with doas:
 
{{cmd|# <editor> /etc/doas.d/doas.conf}}
 
add this to a new line:
{{cmd|# permit persist :wheel}}
 
<br>
 
Switch to the new account type '''exit''' in the shell and login with the new user,
 
<br>
 
== Repositories ==
 
The AlpineLinux software repositories have three branches:
 
* '''Main''': Main packages are the Alpine software that has direct support and updates from the Alpine core and main team. They also have official special documentation, are always available for all releases and will have substitutions if some are not continued from upstream. Commonly, those packages are selected due to their responsibility and stability with respect to upstream availability. When those in ''testing'' perform well or are mature, they go to the ''main'' branch.
* '''Community''': Community packages are those made by users in concert with the official developers and integrated into the Alpine packages. They are user supported. Support could end if the user ends support with respect to Alpine work. For example, could not include substitution in next release due to lack of support by the upstream author. They are in ''edge'' and when accepted, go to the ''community'' branch.
* '''Edge''': New packages come into testing repositories of the edge Alpine version and are those made by any contributor or man power on Alpine. The edge contains unstable current development content. This branch has no release linked or related to Alpine. They are in ''testing'' and when accepted, go to the ''community'' branch.
 
By default only the '''main''' repository is enabled, most users will probably want to enable the '''community''' repository, to enable a repository remove the '''#''' in front of the url along with any blank space.
 
<br>
 
(Example) Disabled:
{{cat|/etc/apk/repositories|#http://dl-cdn.alpinelinux.org/alpine/v3.15/community}}
 
(Example) Enabled:
{{cat|/etc/apk/repositories|http://dl-cdn.alpinelinux.org/alpine/v3.15/community}}
 
 
<br>
 
To edit the repositories open the file in a text editor:
{{cmd|# <editor> /etc/apk/repositories}}
 
<br>
 
Example default configuration:
 
{{cat|/etc/apk/repositories|#/media/cdrom/apks
http://dl-cdn.alpinelinux.org/alpine/v3.15/main
# http://dl-cdn.alpinelinux.org/alpine/v3.15/community
#http://dl-cdn.alpinelinux.org/alpine/edge/main
#http://dl-cdn.alpinelinux.org/alpine/edge/community
#http://dl-cdn.alpinelinux.org/alpine/edge/testing}}
 
{{Note|The edge repositories contain unstable and/or possibly untested packages use at your own risk!}}
 
<br>
 
To avoid having to manually update the verison in '''/etc/apk/repositories''' for each Alpine Linux update, change '''v.3.15''' to '''latest-stable'''
 
Example:
{{cat|/etc/apk/repositories|#/media/cdrom/apks
http://dl-cdn.alpinelinux.org/alpine/latest-stable/main
http://dl-cdn.alpinelinux.org/alpine/latest-stable/community
#http://dl-cdn.alpinelinux.org/alpine/edge/main
#http://dl-cdn.alpinelinux.org/alpine/edge/community
#http://dl-cdn.alpinelinux.org/alpine/edge/testing}}
 
{{Note|Changing the repositories to latest-stable may initiate unexpected release upgrades, do this at your own risk!}}
 
<br>
 
For [https://en.wikipedia.org/wiki/HTTPS#Technical security reasons] it may be a good idea to change the url's from '''http''' to '''https'''
 
Example:
{{cat|/etc/apk/repositories|#/media/cdrom/apks
https://dl-cdn.alpinelinux.org/alpine/v3.15/main
https://dl-cdn.alpinelinux.org/alpine/v3.15/community
#https://dl-cdn.alpinelinux.org/alpine/edge/main
#https://dl-cdn.alpinelinux.org/alpine/edge/community
#https://dl-cdn.alpinelinux.org/alpine/edge/testing}}
 
{{Note|some Alpine Linux package mirrors may not support https, if that is the case you will need to revert back or change mirrors}}
 
<br>
 
Once you have edited '''/etc/apk/repositories''' sync the repositories with:
 
{{cmd|# apk update}}
 
<br>
 
== Installing a Display Server (for graphical sessions) ==
<br>
 
==== Xorg ====
Most desktop enviroments (DE) or Windows Managers (WM) require Xorg (also called: X11, X), although in the future many will fully migrate to [[Wayland]] currently Xorg is still widely used,
 
<br>
 
There is two ways you can get Xorg installed,
 
<br>
 
By default Alpine Linux provides a script that will install Xorg, run the following command to install Xorg:
{{cmd|# setup-xorg-base}}
 
or
 
{{cmd|# apk add xorg-server xorg-server-common xorg-server-dev xorgproto xorgxrdp xorgxrdp-dev}}
{{Note| the apk add method is probably incomplete}}
 
<br>
 
==== Wayland ====
''See also: [[Wayland]]''
 
{{Expand|Wayland documentation needs to be expanded}}
 
<br>
 
== Fonts ==
 
If you plan to use a graphical environment you may need/want to setup fonts
{{Note|depending on the desktop environment/window manager fonts may or may not be installed automatically or as dependencies}}
 
'''See: [[Fonts|Fonts]]'''
 
<br>
 
== Installing a desktop environment or window manager ==
 
'''See: [[Desktop environments and Window managers]]'''
 
<br>
 
== Sound ==
 
By default Alpine doesnt come with any Sound managment out of the box, these are your options:
 
* [[PipeWire]]
* [[PulseAudio]]
* [[ALSA]]
 
{{Note|If your unsure {{Pkg|pipewire}} is the recommended option}}
 
<br>
 
== Troubleshooting ==
 
==== I dont have permission to do anything in my user's home directory ====
 
By default the permissions of your new user(s) home directory may be limited to the root account, run one of these commands to change that:
 
{{cmd|# chmod 700 /home/<YourUsername>}}
 
or
 
{{cmd|# chmod 777 /home/<YourUsername>}}
 
<br>
 
== See also ==
* [[Installation]]
* [[Alpine newbie]]

Latest revision as of 04:17, 29 May 2025

Redirect to:

Retrieved from "https://wiki.alpinelinux.org/w/index.php?title=Post_installation&oldid=30080"