Alpine Linux - User contributions [en]

User:Lilith

2026-04-30T02:04:46Z

Lilith:

i like alpine linux

[mailto:lilithcat@getgoogleoff.me email]

User talk:Lilith

2025-09-23T12:29:46Z

Lilith:

User talk:Lilith

2025-09-23T12:29:16Z

Lilith: make a talk page for myself

*paws at you* beep

Distrobox

2025-09-22T20:19:09Z

Lilith: add important remark to my earlier troubleshooting contribution

[https://distrobox.it/ Distrobox] allows running any Linux distribution inside your terminal. Distrobox uses [[Podman]], [[Docker]] etc.. to create containers using the Linux distribution of your choice. This enables both backward and forward compatibility with software and freedom to use whatever distribution you’re more comfortable with.

== Installation ==

Installing {{pkg|distrobox}} package automatically installs [[Podman]] as a dependency, on issuing the command:{{cmd|# apk add {{pkg|distrobox}}}}

== Running graphical programs ==

Configure Podman to run in [[Podman#Running in rootless mode|rootless mode]].

Create a container using an image of your choice. Here Debian is installed using the command:{{cmd|$ distrobox create --name my-debian --image debian
$ distrobox enter my-debian}}

When [[Wayland]] desktop like [[Sway]] runs without {{pkg|xwayland}} on the Alpine Linux host, electron apps like {{ic|vscode}}, {{ic|google-chrome}} etc needs to be started as follows:{{ic|<nowiki>$ distrobox enter my-debian -- code --ozone-platform=wayland</nowiki>}}.

If you are running X11 desktop, it may also be necessary to allow X authorization for GUI programs to work: {{ic|$ xhost +si:localuser:$USER}}

== Troubleshooting ==

=== Permission problems with rootless Podman ===

You may encounter an error when entering your rootless container:

<code>Error: unable to start container "XYZ": runc: runc create failed: unable to start container process: unable to apply cgroup configuration: rootless needs no limits + no cgrouppath when no permission is granted for cgroups: mkdir /sys/fs/cgroup/XYZ: permission denied: OCI permission denied</code>

This problem may be solved by installing {{Pkg|crun}}: {{Cmd|# apk add crun}}

and recreating your container. Keep in mind that {{Pkg|crun}} replaces {{Pkg|runc}}, which will render containers made with the latter unusable until recreated.

== See also ==

* [https://distrobox.it/ Official website]
* [[Podman]]
* [[Docker]]

[[Category:Virtualization]]

Using Distrobox For VR Gaming

2025-09-22T19:51:08Z

Lilith: use cmd element for commands

This page intends to walk you through setting up your own [[Distrobox]] container for [[VR]] gaming with [[Steam]], [https://store.steampowered.com/app/250820/SteamVR/ SteamVR], [https://monado.freedesktop.org/ Monado] (Note: You may not need SteamVR) and a tool you might find useful for interacting with your desktop.

== Why Distrobox? ==
In short, this ensures programs we'll use have access to dependencies they need. To elaborate: you may choose to run programs that need [https://www.gnu.org/software/libc/ glibc] among other things, such as Steam. Typically you can circumvent this by installing them with [[Flatpak]], which provides them with such dependencies, however also sandboxes them and that may prevent you from using certain hardware as the applications cannot have access to it, or even your host's software.

Distrobox does this without the sandbox.

== Before You Start ==
There may be some prerequisites first.

Go ahead and install <code>steam-devices</code> and <code>libcap</code> to ensure your devices can be used
and to set the right capabilities of the SteamVR binary respectively later on. You need to have <code>main</code> and <code>community</code> repositories enabled at the very least, <code>testing</code> may be useful aswell

{{Cmd|# apk add steam-devices libcap}}

If you haven't already, please set up [[Distrobox]] as per the page's instructions to install it and configure Podman to run in rootless mode (however we will be using a rootful container).

Also, make sure your Desktop environment or Wayland compositor implements the DRM leasing protocol if you have a wired headset (e.g. HTC Vive or Valve Index), see [https://wayland.app/protocols/drm-lease-v1#compositor-support here]

== Setting Up Your Container ==
To do this as cleanly as possible, it's recommended that you make a directory to store your container's home, so that it doesn't pollute your host's home.

You may call the container whatever you want, this guide will use "vrbox"

{{Cmd|$ mkdir -p ~/Containers/vrbox}}

Next is actually creating the container in question. We will name it "vrbox", set the hostname to the same name, and choose a convenient image for the container, this example uses the latest [https://fedoraproject.org/ Fedora] image. It's possible to use rawhide or any distro you'd like, what matters is that it works. Note the <code>--root</code> argument, which creates a rootful container, and you will need to use it with every enter command to access the container.

Remember to substitute <code><user></code> with your username.

{{Cmd|$ distrobox create --home /home/<user>/Containers/vrbox --name vrbox --hostname vrbox --image fedora:latest --root}}

Now, enter your container to initialize it

{{Cmd|$ distrobox enter --root vrbox}}

== Installing Steam and SteamVR ==
And this is where the fireworks come in as we begin installing Steam itself. To do that you will need to install the free and nonfree [https://rpmfusion.org/ rpm fusion] repositories like so.

{{Cmd|$ distrobox enter --root vrbox -- sudo dnf install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-42.noarch.rpm https://mirrors.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-42.noarch.rpm -y}}

{{Note|The version number used in the links will depend on what version of Fedora you chose for your container. As of writing this guide, the latest version was the answer to life, the universe and everything (42).}}

Additionally, the [https://docs.fedoraproject.org/en-US/gaming/proton/ Fedora documentation] mentions needing this

{{Cmd|$ distrobox enter --root vrbox -- sudo dnf config-manager setopt fedora-cisco-openh264.enabled=1 }}

Finally, install Steam

{{Cmd|$ distrobox enter --root vrbox -- sudo dnf install steam -y}}

After this, you will need to launch Steam and login and install SteamVR.

{{Cmd|$ distrobox enter --root vrbox -- steam}}

Try to launch it once or twice, notice it may or may not work already. To make sure it does, set the right capabilities to the binary and relaunch

{{Cmd|# setcap CAP_SYS_NICE+ep /home/user/Containers/vrbox/.steam/steam/steamapps/common/SteamVR/bin/linux64/vrcompositor-launcher}}

=== Common SteamVR Issues ===
SteamVR on Linux often has plenty of issues, here's how to mitigate the ones you may run into.

==== Room Setup Cannot Launch Or Crashes Instantly ====
You can use Quick Calibration to circumvent Room Setup, as noted in [https://lvra.gitlab.io/docs/steamvr/#room-setup this LVRA wiki page]

<blockquote>
Set the headset and controllers on the floor in the center of the playspace. Run the Quick Calibration utility from the SteamVR-Monitor (the desktop utility showing basestations, headset and controller icons) under Settings > Developer > Room and Tracking. This will setup a standing play area for you to use.
</blockquote>

If the Settings window crashes when selecting Developer, [https://help.steampowered.com/en/faqs/view/4F5E-AD22-7402-2EAD try opting into SteamVR Beta] first. When calibrated, you should switch back to the stable SteamVR (opt out of Beta).

==== Turning On Controllers Launches SteamVR ====
Why is this an issue? It may be if you happen to want to use Monado instead (explained later in this guide), as you do not want to run SteamVR and [https://lvra.gitlab.io/docs/fossvr/envision/ Envision]/Monado at the same time.

The steps to disable this are in LVRA wiki on [https://lvra.gitlab.io/docs/fossvr/monado/#steam this page]

== Why Monado/WiVRn? ==
It's simple, as SteamVR has a pile of issues, for example lack of reprojection (this means the inside of your headset will be stuttery) or otherwise general bugs and worse performance. Monado doesn't have these issues.

Monado is for wired headsets such as the HTC Vive. [https://lvra.gitlab.io/docs/fossvr/wivrn/ WiVRn] is based on Monado.

== Using Monado Instead of SteamVR with Envision ==
If you have done everything else right so far, you should be able to install Envision, which will help you setup Monado easily

{{Cmd|$ distrobox enter --root vrbox -- sudo dnf install git envision envision-monado}}

With this done, simply launch Envision like so

{{Cmd|$ distrobox enter --root vrbox -- envision}}

Make sure to read up on [https://lvra.gitlab.io/docs/fossvr/envision/ Envision] to know how to use it. After building a profile, it might ask you to set the right capabilities for the Monado binary, which you would do in essentially the same way as for SteamVR's binary.

== Using WiVRn Instead of SteamVR for Standalone Headsets ==
In contrast (but not really) to Monado, there's WiVRn for standalone headsets such as the Quest.
You have a few options with this, as you can continue with the Distrobox trend and install it using

{{Cmd|$ distrobox enter --root vrbox -- sudo dnf install wivrn}}

And proceed to also [https://rpmfusion.org/Howto/Multimedia install required codecs].

Alternatively, you could simply not bother with Distrobox and go the [[Flatpak]] way (including Flatpak [[Steam]])

{{Cmd|$ flatpak install io.github.wivrn.wivrn}}

But you will need to do extra setup as explained [https://lvra.gitlab.io/docs/fossvr/wivrn/ in the WiVRn LVRA wiki page].

== Running Additional Software for VR/XR ==
For example [https://github.com/galister/wlx-overlay-s WlxOverlay-S], which allows you to interact with your desktop inside VR.

Running it is simple, the procedure is as follows:

#Download the relevant AppImage or binary
#Move it somewhere in your container's home directory, i.e. ~/Containers/vrbox/wlx/
#Make it executable using
#*{{Cmd|$ chmod +x ~/Containers/vrbox/wlx/WlxOverlay-S-*.AppImage}}
#Run it using (use the correct path)
#*{{Cmd|$ distrobox enter --root vrbox -- ~/Containers/vrbox/wlx/WlxOverlay-S-xxx.AppImage}}

WlxOverlay-S specifically requires functional xdg desktop portals, like those seen here in [[PipeWire#Screen_sharing_on_Wayland]], and it may be important for you to setup Pipewire using its user service as showed in [[PipeWire#Pipewire_user_service]]

== See Also ==
[https://lvra.gitlab.io/ Linux VR Adventures Wiki (LVRA)]

[[Category:Gaming]]

Distrobox

2025-09-22T19:39:46Z

Lilith:

[https://distrobox.it/ Distrobox] allows running any Linux distribution inside your terminal. Distrobox uses [[Podman]], [[Docker]] etc.. to create containers using the Linux distribution of your choice. This enables both backward and forward compatibility with software and freedom to use whatever distribution you’re more comfortable with.

== Installation ==

Installing {{pkg|distrobox}} package automatically installs [[Podman]] as a dependency, on issuing the command:{{cmd|# apk add {{pkg|distrobox}}}}

== Running graphical programs ==

Configure Podman to run in [[Podman#Running in rootless mode|rootless mode]].

Create a container using an image of your choice. Here Debian is installed using the command:{{cmd|$ distrobox create --name my-debian --image debian
$ distrobox enter my-debian}}

When [[Wayland]] desktop like [[Sway]] runs without {{pkg|xwayland}} on the Alpine Linux host, electron apps like {{ic|vscode}}, {{ic|google-chrome}} etc needs to be started as follows:{{ic|<nowiki>$ distrobox enter my-debian -- code --ozone-platform=wayland</nowiki>}}.

If you are running X11 desktop, it may also be necessary to allow X authorization for GUI programs to work: {{ic|$ xhost +si:localuser:$USER}}

== Troubleshooting ==

=== Permission problems with rootless Podman ===

You may encounter an error when entering your rootless container:

<code>Error: unable to start container "XYZ": runc: runc create failed: unable to start container process: unable to apply cgroup configuration: rootless needs no limits + no cgrouppath when no permission is granted for cgroups: mkdir /sys/fs/cgroup/XYZ: permission denied: OCI permission denied</code>

This problem may be solved by installing {{Pkg|crun}}: {{Cmd|# apk add crun}}

and recreating your container.

== See also ==

* [https://distrobox.it/ Official website]
* [[Podman]]
* [[Docker]]

[[Category:Virtualization]]

Using Distrobox For VR Gaming

2025-09-22T15:52:14Z

Lilith: small corrections

This page intends to walk you through setting up your own [[Distrobox]] container for [[VR]] gaming with [[Steam]], [https://store.steampowered.com/app/250820/SteamVR/ SteamVR], [https://monado.freedesktop.org/ Monado] (Note: You may not need SteamVR) and a tool you might find useful for interacting with your desktop.

== Why Distrobox? ==
In short, this ensures programs we'll use have access to dependencies they need. To elaborate: you may choose to run programs that need [https://www.gnu.org/software/libc/ glibc] among other things, such as Steam. Typically you can circumvent this by installing them with [[Flatpak]], which provides them with such dependencies, however also sandboxes them and that may prevent you from using certain hardware as the applications cannot have access to it, or even your host's software.

Distrobox does this without the sandbox.

== Before You Start ==
There may be some prerequisites first.

Go ahead and install <code>steam-devices</code> and <code>libcap</code> to ensure your devices can be used
and to set the right capabilities of the SteamVR binary respectively later on. You need to have <code>main</code> and <code>community</code> repositories enabled at the very least, <code>testing</code> may be useful aswell

# apk add steam-devices libcap

If you haven't already, please set up [[Distrobox]] as per the page's instructions to install it and configure Podman to run in rootless mode (however we will be using a rootful container).

Also, make sure your Desktop environment or Wayland compositor implements the DRM leasing protocol if you have a wired headset (e.g. HTC Vive or Valve Index), see [https://wayland.app/protocols/drm-lease-v1#compositor-support here]

== Setting Up Your Container ==
To do this as cleanly as possible, it's recommended that you make a directory to store your container's home, so that it doesn't pollute your host's home.

You may call the container whatever you want, this guide will use "vrbox"

$ mkdir -p ~/Containers/vrbox

Next is actually creating the container in question. We will name it "vrbox", set the hostname to the same name, and choose a convenient image for the container, this example uses the latest [https://fedoraproject.org/ Fedora] image. It's possible to use rawhide or any distro you'd like, what matters is that it works. Note the <code>--root</code> argument, which creates a rootful container, and you will need to use it with every enter command to access the container.

Remember to substitute <code><user></code> with your username.

$ distrobox create --home /home/<user>/Containers/vrbox --name vrbox --hostname vrbox --image fedora:latest --root

Now, enter your container to initialize it

$ distrobox enter --root vrbox

== Installing Steam and SteamVR ==
And this is where the fireworks come in as we begin installing Steam itself. To do that you will need to install the free and nonfree [https://rpmfusion.org/ rpm fusion] repositories like so.

$ distrobox enter --root vrbox -- sudo dnf install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-42.noarch.rpm https://mirrors.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-42.noarch.rpm -y

{{Note|The version number used in the links will depend on what version of Fedora you chose for your container. As of writing this guide, the latest version was the answer to life, the universe and everything (42).}}

Additionally, the [https://docs.fedoraproject.org/en-US/gaming/proton/ Fedora documentation] mentions needing this

$ distrobox enter --root vrbox -- sudo dnf config-manager setopt fedora-cisco-openh264.enabled=1

Finally, install Steam

$ distrobox enter --root vrbox -- sudo dnf install steam -y

After this, you will need to launch Steam and login and install SteamVR.

$ distrobox enter --root vrbox -- steam

Try to launch it once or twice, notice it may or may not work already. To make sure it does, set the right capabilities to the binary and relaunch

# setcap CAP_SYS_NICE+ep /home/user/Containers/vrbox/.steam/steam/steamapps/common/SteamVR/bin/linux64/vrcompositor-launcher

=== Common SteamVR Issues ===
SteamVR on Linux often has plenty of issues, here's how to mitigate the ones you may run into.

==== Room Setup Cannot Launch Or Crashes Instantly ====
You can use Quick Calibration to circumvent Room Setup, as noted in [https://lvra.gitlab.io/docs/steamvr/#room-setup this LVRA wiki page]

<blockquote>
Set the headset and controllers on the floor in the center of the playspace. Run the Quick Calibration utility from the SteamVR-Monitor (the desktop utility showing basestations, headset and controller icons) under Settings > Developer > Room and Tracking. This will setup a standing play area for you to use.
</blockquote>

If the Settings window crashes when selecting Developer, [https://help.steampowered.com/en/faqs/view/4F5E-AD22-7402-2EAD try opting into SteamVR Beta] first. When calibrated, you should switch back to the stable SteamVR (opt out of Beta).

==== Turning On Controllers Launches SteamVR ====
Why is this an issue? It may be if you happen to want to use Monado instead (explained later in this guide), as you do not want to run SteamVR and [https://lvra.gitlab.io/docs/fossvr/envision/ Envision]/Monado at the same time.

The steps to disable this are in LVRA wiki on [https://lvra.gitlab.io/docs/fossvr/monado/#steam this page]

== Why Monado/WiVRn? ==
It's simple, as SteamVR has a pile of issues, for example lack of reprojection (this means the inside of your headset will be stuttery) or otherwise general bugs and worse performance. Monado doesn't have these issues.

Monado is for wired headsets such as the HTC Vive. [https://lvra.gitlab.io/docs/fossvr/wivrn/ WiVRn] is based on Monado.

== Using Monado Instead of SteamVR with Envision ==
If you have done everything else right so far, you should be able to install Envision, which will help you setup Monado easily

$ distrobox enter --root vrbox -- sudo dnf install git envision envision-monado

With this done, simply launch Envision like so

$ distrobox enter --root vrbox -- envision

Make sure to read up on [https://lvra.gitlab.io/docs/fossvr/envision/ Envision] to know how to use it. After building a profile, it might ask you to set the right capabilities for the Monado binary, which you would do in essentially the same way as for SteamVR's binary.

== Using WiVRn Instead of SteamVR for Standalone Headsets ==
In contrast (but not really) to Monado, there's WiVRn for standalone headsets such as the Quest.
You have a few options with this, as you can continue with the Distrobox trend and install it using

$ distrobox enter --root vrbox -- sudo dnf install wivrn

And proceed to also [https://rpmfusion.org/Howto/Multimedia install required codecs].

Alternatively, you could simply not bother with Distrobox and go the [[Flatpak]] way (including Flatpak [[Steam]])

$ flatpak install io.github.wivrn.wivrn

But you will need to do extra setup as explained [https://lvra.gitlab.io/docs/fossvr/wivrn/ in the WiVRn LVRA wiki page].

== Running Additional Software for VR/XR ==
For example [https://github.com/galister/wlx-overlay-s WlxOverlay-S], which allows you to interact with your desktop inside VR.

Running it is simple, the procedure is as follows:

#Download the relevant AppImage or binary
#Move it somewhere in your container's home directory, i.e. ~/Containers/vrbox/wlx/
#Make it executable using
#*{{Cmd|$ chmod +x ~/Containers/vrbox/wlx/WlxOverlay-S-*.AppImage}}
#Run it using (use the correct path)
#*{{Cmd|$ distrobox enter --root vrbox -- ~/Containers/vrbox/wlx/WlxOverlay-S-xxx.AppImage}}

WlxOverlay-S specifically requires functional xdg desktop portals, like those seen here in [[PipeWire#Screen_sharing_on_Wayland]], and it may be important for you to setup Pipewire using its user service as showed in [[PipeWire#Pipewire_user_service]]

== See Also ==
[https://lvra.gitlab.io/ Linux VR Adventures Wiki (LVRA)]

[[Category:Gaming]]

User:Lilith

2025-09-21T14:31:18Z

Lilith:

i like alpine linux

[https://lilith.moe/ website], [mailto:lilithcat@getgoogleoff.me email]

Tutorials and Howtos

2025-09-21T11:32:49Z

Lilith: /* Tutorials */

[[Image:package_edutainment.svg|right|link=]]
{{TOC left}}

'''Welcome to Tutorials and Howtos, a place of basic and advanced configuration tasks for your Alpine Linux.'''

'''Howtos are smaller articles''' explaining how to perform a particular task with Alpine Linux, that expects a minimal knowledge from reader to perform actions. Howto's have been organized in the below page based on the topics.

'''The [[#Tutorials|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 example. The output in one step is the starting point for the following step.

{{Note|
* Contributors are requested to refer to [[Help:Editing]] first and make use of resources like [[How to write a HOWTO]].
* Contributions must be complete articles.
* Don't override already made contributions, unless there is a mistake.
* If you want to request a topic, please add your request in this page's [[Talk:Tutorials_and_Howtos|Discussion]].}}

== Desktop ==

* {{:Daily driver guide}}

=== Networking ===

* [[Bluetooth]] - Instructions for installing and configuring Bluetooth
* [[Bonding]] - Bond (or aggregate) multiple ethernet interfaces
* [[Bridge]] - Configuring a network bridge
** [[Bridge wlan0 to eth0]]
* [[Configure Networking]]
* [[How to configure static routes]]
* Modem
** [[Using HSDPA modem]]
** [[Using serial modem]]
* [[mDNS]] - Howto implement multicast DNS resolution in Alpine.
* [[Multi ISP]] ''(Dual-ISP setup with load-balancing and automatic failover)''
* [[PXE boot]]
* Wi-Fi
** [[Wi-Fi|Connecting to a wireless access point]]
** [[How to setup a wireless access point]] ''(Setting up Secure Wireless AP w/ WPA encryption with bridge to wired network)''
* Use [https://github.com/ifupdown-ng/ifupdown-ng/blob/main/doc/interfaces-vxlan.scd vxlan], if using [[Ifupdown-ng]] instead of [[VLAN]]

=== Backup and data migration ===

* [[Migrating data]]
* [[Rsnapshot]] - setting up periodic backups

=== Other topics ===

* [[Gaming on Alpine]]
* [[Remote Desktop Server]]
* [[Default applications|How to change default application]]
* [[CPU frequency scaling]]
* [[Mimalloc]]
* [[Enable Serial Console on Boot]]
* [[How to build the Alpine Linux kernel]]
* [[Nextcloud]] ''(Self hostable cloud suite - Dropbox Alternative)''
* [[Setting up lm_sensors]]
* [[Fingerprint Authentication with swaylock]]
* [[Desktop environments and Window managers|List of supported Desktop environments and Window managers]]

== Diskless ==

* [[Alpine local backup|Alpine local backup (lbu)]] ''(Permanently store your modifications in case your box needs reboot)''
** [[Back Up a Flash Memory Installation]]
** [[Manually editing a existing apkovl]]

== Other Architectures ==

=== ARM ===

* [[Alpine on ARM]]

==== Raspberry Pi ====

* [[Raspberry Pi|Raspberry Pi main page]]
* [[Raspberry Pi Bluetooth Speaker|Raspberry Pi - Bluetooth Speaker]]
* [[Linux Router with VPN on a Raspberry Pi|Raspberry Pi - Router with VPN]]
* [[Linux Router with VPN on a Raspberry Pi (IPv6)|Raspberry Pi - Router with VPN (IPv6)]]
* [[Classic install or sys mode on Raspberry Pi|Raspberry Pi - Sys mode install]]
* [[Raspberry Pi LVM on LUKS|Raspberry Pi - Sys mode install - LVM on LUKS]]
* [[RPI Video Receiver|Raspberry Pi - Video Receiver]] ''(network video decoder using Rasperry Pi and omxplayer)''
* [[Raspberry Pi 3 - Browser Client]] - kiosk or digital sign
* [[Raspberry Pi 3 - Configuring it as wireless access point -AP Mode]]
* [[Raspberry Pi 3 - Setting Up Bluetooth]]
* [[Raspberry Pi 4 - Persistent system acting as a NAS and Time Machine]]
* [[How to set up Alpine as a wireless router|Raspberry Pi Zero W - Wireless router]] ''(Setting up a firewalled, Wireless AP with wired network on a Pi Zero W)''
* [[RPI Video Receiver]]

=== IBM Z (IBM z Systems) ===

* [[s390x|s390x - Installation]]

=== PowerPC ===

* [[Ppc64le|Powerpc64le - Installation]]

== Security ==

* [[#Desktop security|Desktop security]] lists steps for securing Alpine Linux desktops
* [[Setting up a laptop]] page has detailed guidelines to configure a secured laptop
* [[Securing Alpine Linux|Secure Alpine Linux]] using Security Technical Implementation Guides (STIGs)

== Services ==

{{Note| Services are arranged in alphabetical order.}}

=== Content management systems ===

* [[DokuWiki]] ''(Simple and easy to use wiki, no database required)''
* [[Drupal]] ''(Content Management System (CMS) written in PHP)''
* [[Kopano]] ''(Microsoft Outlook compatible Groupware)''
* [[Mahara]] ''(E-portfolio and social networking system)''
* [[MediaWiki]] ''(Free web-based wiki software application)''
* [[Pastebin]] ''(Pastebin software application)''
* [[WordPress]] ''(Web software to create website or blog)''
* [[Moodle]] ''(Online Learning Management system)''

=== Database ===

* [[MariaDB]] or [[MySQL|MySQL]]

=== DNS ===

* [[DNSCrypt-Proxy]] ''Encrypt and authenticate DNS calls from your system''
* [[Setting up nsd DNS server]]
* [[Small-Time DNS with BIND9]] ''(A simple configuration with ad blocking for your home network)''
* Unbound
** [[Setting up unbound DNS server]]
** [[Using Unbound as an Ad-blocker]] ''(Setup ad blocking for your network)''
* [[TinyDNS Format]]

=== File server ===

* [[Setting up an NFS server|nfs-server]]
* [[Setting up a Samba server|samba-server]] ''(standard file sharing)''
* [[Setting up a samba-ad-dc|samba-ad-dc]] ''(Active Directory compatible domain controller)''

=== Firewall ===

* [https://git.alpinelinux.org/awall/about/ Alpine Wall User's Guide]
** [[Zero-To-Awall]] -''AWall for dummies''
** [[How-To Alpine Wall]] - ''AWall for Shorewall users''
** [[Alpine Wall]] - ''AWall - Firewall management framework - Design Document''
* [[Iptables]]
* [[nftables]]
* [[Uncomplicated Firewall|Uncomplicated Firewall or UFW]]

=== HTTP and web services ===

* [[Althttpd]]
* [[Apache]]
** [[Apache with php-fpm]]
** [[Setting Up Apache with PHP]]
** [[Apache authentication: NTLM Single Signon]]
* [[Darkhttpd]]
* [[Lighttpd]]
** [[Lighttpd Advanced security]]
** [[Setting Up Lighttpd With FastCGI]]
** [[Production Web server: Lighttpd|Production web server: Lighttpd‎‎]]
* [[Nginx]]
** [[Nginx as reverse proxy with acme (letsencrypt)]]
** [[Nginx with PHP]]
* Squid Proxy
** [[Obtaining user information via SNMP]] ''(Using squark-auth-snmp as a Squid authentication helper)'' 
** [[Setting up Explicit Squid Proxy]]
** [[Setting up Transparent Squid Proxy]] ''(Covers Squid proxy and URL Filtering system)''
** [[SqStat]] ''(Script to look at active squid users connections)''
* [[Tomcat]]
** [[Production LAMP system: Lighttpd + PHP + MySQL‎‎|Production LAMP system: Lighttpd + PHP + MariaDB/MySQL‎‎]]

=== IRC ===

* [[NgIRCd]] ''(Server for Internet Relay Chat/IRC)''

=== Mail ===

* [[Hosting services on Alpine]] ''(Hosting mail, webservices and other services)''
* [[Hosting Web/Email services on Alpine]]
* Exim/Dovecot
** [[Small-Time Email with Exim and Dovecot]] ''(A simple configuration for your home network.)
** [[Setting up dovecot with imap and tls]]
* [[relay email to gmail (msmtp, mailx, sendmail]]
* [[relay email (nullmailer)]]
* [[Roundcube]] ''(Webmail system)''
* [[Setting up postfix with virtual domains]]
* Server protection
** [[Setting up clamsmtp]]

=== Monitoring ===

* [[Awstats]] ''(Free log file analyzer)''
* [[Cacti: traffic analysis and monitoring network]] ''(Front-end for rrdtool networking monitor)''
* [[Cvechecker]] ''(Compare installed packages for Common Vulnerabilities Exposure)'' 
* [[Linfo]]
* [[Obtaining user information via SNMP]] ''(Using squark-auth-snmp as a Squid authentication helper)'' 
* [[PhpSysInfo]] ''(A simple application that displays information about the host it's running on)''
* [[Logcheck]] ''(log file monitoring tool)''
* [[Matomo]] ''(A real time web analytics software program)''
* [[Rasdaemon]] ''(Platform Reliability, Availability and Serviceability monitoring tool)''
* [[Setting up A Network Monitoring and Inventory System]] ''(Nagios + OpenAudit and related components)'' 
** [[Setting up NRPE daemon]] ''(Performs remote Nagios checks)'' 
* [[Setting Up Fprobe And Ntop|Ntop]] ''(NetFlow collection and analysis using a remote fprobe instance; for alpine 3.10-3.12 only)'' 
* [[SqStat]] ''(Script to look at active squid users connections)''
* [[Traffic monitoring]] 
** [[Setting up monitoring using rrdtool (and rrdcollect)]]
** [[Setting up traffic monitoring using rrdtool (and snmp)]] 
* [[Zabbix|Zabbix - the professional complete manager]] ''(Monitor and track the status of network services and hardware)''
* [[ZoneMinder video camera security and surveillance]]

=== Remote Administration ===

* ACF
** [[Changing passwords for ACF|ACF - changing passwords]]
** [[Generating SSL certs with ACF]] 
** [[setup-acf| ACF - setup]] ''(Configures ACF (webconfiguration/webmin) so you can manage your box through https)''
* [[Setting up a SSH server]] ''(Using ssh is a good way to administer your box remotely)''
** [[HOWTO OpenSSH 2FA with password and Google Authenticator |OpenSSH 2FA]] ''(A simple two factor setup for OpenSSH)''
* [[OpenVCP]] ''(VServer Control Panel)''
* [[PhpMyAdmin]] ''(Web-based administration tool for MYSQL)''
* [[PhpPgAdmin]] ''(Web-based administration tool for PostgreSQL)''
* [[Webmin]] ''(A web-based interface for Linux system)''

=== Telephony ===

* [[FreePBX|FreePBX on Alpine Linux]]
* [[Setting up Zaptel/Asterisk on Alpine]]
* [[Kamailio]] ''(SIP Server, formerly OpenSER)''

=== VPN ===
* [[Freeradius Active Directory Integration]]
* [[GNUnet]]
* [[IGMPproxy]]
* [[Setting up a OpenVPN server|OpenVPN server]] ''(Allowing single users or devices to remotely connect to your network)''
* [[OpenVSwitch]]
* [[Tor]]
* [[Using Alpine on Windows domain with IPSEC isolation]]
* [[Configure a Wireguard interface (wg)|Wireguard]]

=== Other Servers ===

* [[apcupsd]] ''(UPS Monitoring with apcupsd)''
* [[Chrony and GPSD | Chrony, gpsd, and a garmin LVC 18 as a Stratum 1 NTP source ]]
* [[Glpi]] ''(Manage inventory of technical resources)''
* [[How to setup a Alpine Linux mirror]]
* [[nut-ups|NUT UPS]] ''(UPS Monitoring with Network UPS Tools)''
* [[Odoo]]
* [[Configure OpenLDAP | OpenLDAP]] ''(Installing and configuring the Alpine package for OpenLDAP)''
* [[Setting up a LLDAP server|lldap-server]] ''(Directory Server)''
* [[Setting up Transmission (bittorrent) with Clutch WebUI]]

== Software development ==

* [[Cgit]]
* [[OsTicket]] ''(Ticket system)''
* [[Patchwork]] ''(Patch review management system)''
* [[Redmine]] ''(Project management system) [Deprecated]''
* [[Request Tracker]] ''(Ticket system)''
* [[Setting up trac wiki|Trac]] ''(Enhanced wiki and issue tracking system for software development projects)''
* [[Ansible]] ''(Configuration management)''
* [[Installing Oracle Java|Oracle Java (installation)]]

== Storage ==

* [[Setting up disks manually|Manual partitioning]]
* [[Disk Replication with DRBD|DRBD: Disk Replication]]
* [[Filesystems]]
** [[Burning ISOs]]
* [[Setting up iSCSI|iSCSI Setup]]
** [[iSCSI Raid and Clustered File Systems]]
** [[Linux iSCSI Target (TCM)|iSCSI Target (TCM)/LinuxIO (LIO)]]
** [[Linux iSCSI Target (tgt)|User space iSCSI Target (tgt)]]
* [[Setting up Logical Volumes with LVM|LVM Setup]]
** [[Setting up LVM on GPT-labeled disks|LVM on GPT-labeled disks]]
** [[Installing on GPT LVM|LVM on GPT-labeled disks (updated)]]
** [[LVM on LUKS]]
* RAID
** [[Raid Administration]]
** [[Setting up a software RAID array]]
* [[ZFS]]
** [[Root on ZFS with native encryption]]
** [[Setting up ZFS on LUKS]]
* [[CEPH|CEPH]]

== Virtualization ==

* [[Docker]]
* [[Installing Alpine in a virtual machine]]
** [[Install Alpine on VMware ESXi]]
* [[KVM]] ''(Setting up Alpine as a KVM hypervisor)''
* [[LXC]] ''(Setting up a Linux container in Alpine Linux)''
* [[QEMU]]
* Xen
** [[Xen Dom0]] ''(Setting up Alpine as a dom0 for Xen hypervisor)''
** [[Xen Dom0 on USB or SD]]
** [[Create Alpine Linux PV DomU|Xen DomU (paravirtualized)]]
** [[Xen LiveCD]]
** [[Xen PCI Passthrough]]
** [[K8s]] Building a K8s Kubernetes Cluster on Alpine Linux
* [[Runc]]

== [[Simple_Walkthrough]] ==

* [[LXC_Alpinelinux_Simple]]
* [[Qemu-simple]]

== Tutorials ==

* [[TTY_Autologin|TTY Autologin]]
* [[Kexec|Faster rebooting with kexec]]
* [[Dynamic Multipoint VPN (DMVPN)]] combined with [[Small Office Services]]
* [[DIY Fully working Alpine Linux for Allwinner and Other ARM SOCs]]
* [[Fault Tolerant Routing with Alpine Linux]]
* [[High Availability High Performance Web Cache]] ''(uCarp + HAProxy for High Availability Services such as Squid web proxy)''
* [[Linux iSCSI Target (TCM)]]
* [[ISP Mail Server 3.x HowTo]] ''(Postfix+PostfixAdmin+DoveCot+Roundcube+ClamAV+Spamd - A full-service ISP mail server)''
* [[Grommunio Mail Server]] ''(Mariadb+Postfix+Rspamd+Grommunio - Full-service mail server as MS exchange replacement)''
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Setting up A Network Monitoring and Inventory System]] ''(Nagios + OpenAudit and related components)'' 
* [[Streaming Security Camera Video with VLC]]
* [[Install Alpine on a btrfs filesystem with refind as boot manager]]
* [[Compile software from source|How to Compile a software from source in Alpine Linux]]
* [https://ww2.coastal.edu/mmurphy2/oer/alpine/ Alpine Linux tutorials - Dr Murphy, Computing Science Associate Professor]
* [[Michael's base installation procedure|Michael's base installation procedure]]
* [[Michael's sway desktop (minimal)|Michael's sway desktop (minimal)]]
* [[Michael's cwm desktop (minimal)|Michael's cwm desktop (minimal)]]
* [[Using Distrobox For VR Gaming|Using Distrobox For VR Gaming]]

Using Distrobox For VR Gaming

2025-09-21T11:29:21Z

Lilith: A tutorial for setting up a container to play SteamVR games

This page intends to walk you through setting up your own [[Distrobox]] container for [[VR]] gaming with [[Steam]], [https://store.steampowered.com/app/250820/SteamVR/ SteamVR], [https://monado.freedesktop.org/ Monado] (Note: You may not need SteamVR) and a tool you might find useful for interacting with your desktop.

== Why Distrobox? ==
In short, this ensures programs we'll use have access to dependencies they need. To elaborate: you may choose to run programs that need [https://www.gnu.org/software/libc/ glibc] among other things, such as Steam. Typically you can circumvent this by installing them with [[Flatpak]], which provides them with such dependencies, however also sandboxes them and that may prevent you from using certain hardware as the applications cannot have access to it, or even your host's software.

Distrobox does this without the sandbox.

== Before You Start ==
There may be some prerequisites first.

Go ahead and install <code>steam-devices</code> and <code>libcap-setcap</code> to ensure your devices can be used
and to set the right capabilities of the SteamVR binary respectively later on. You need to have <code>main</code> and <code>community</code> repositories enabled at the very least, <code>testing</code> may be useful aswell

# apk add steam-devices libcap-setcap

If you haven't already, please set up [[Distrobox]] as per the page's instructions to install it and configure Podman to run in rootless mode (However we will be using a rootful container).

Also, make sure your Desktop environment or Wayland compositor implements the DRM leasing protocol if you have a wired headset (e.g. HTC Vive or Valve Index), see [https://wayland.app/protocols/drm-lease-v1#compositor-support here]

== Setting Up Your Container ==
To do this as cleanly as possible, it's recommended that you make a directory to store your container's home, so that it doesn't pollute your host's home.

You may call the container whatever you want, this guide will use "vrbox"

$ mkdir -p ~/Containers/vrbox

Next is actually creating the container in question. We will name it "vrbox", set the hostname to the same name, and choose a convenient image for the container, this example uses the latest [https://fedoraproject.org/ Fedora] image. It's possible to use rawhide or any distro you'd like, what matters is that it works. Note the <code>--root</code> argument, which creates a rootful container, and you will need to use it with every enter command to access the container.

Remember to substitute <code><user></code> with your username.

$ distrobox create --home /home/<user>/Containers/vrbox --name vrbox --hostname vrbox --image fedora:latest --root

Now, enter your container to initialize it

$ distrobox enter --root vrbox

== Installing Steam and SteamVR ==
And this is where the fireworks come in as we begin installing Steam itself. To do that you will need to install the free and nonfree [https://rpmfusion.org/ rpm fusion] repositories like so.

$ distrobox enter --root vrbox -- sudo dnf install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-42.noarch.rpm https://mirrors.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-42.noarch.rpm -y

{{Note|The version number used in the links will depend on what version of Fedora you chose for your container. As of writing this guide, the latest version was the answer to life, the universe and everything (42).}}

Additionally, the [https://docs.fedoraproject.org/en-US/gaming/proton/ Fedora documentation] mentions needing this

$ distrobox enter --root vrbox -- sudo dnf config-manager setopt fedora-cisco-openh264.enabled=1

Finally, install Steam

$ distrobox enter --root vrbox -- sudo dnf install steam -y

After this, you will need to launch Steam and login and install SteamVR.

$ distrobox enter --root vrbox -- steam

Try to launch it once or twice, notice it may or may not work already. To make sure it does, set the right capabilities to the binary and relaunch

# setcap CAP_SYS_NICE+ep /home/user/Containers/vrbox/.steam/steam/steamapps/common/SteamVR/bin/linux64/vrcompositor-launcher

=== Common SteamVR Issues ===
SteamVR on Linux often has plenty of issues, Here's how to mitigate the ones you may run into.

==== Room Setup Cannot Launch Or Crashes Instantly ====
You can use Quick Calibration to circumvent Room Setup, as noted in [https://lvra.gitlab.io/docs/steamvr/#room-setup this LVRA wiki page]

<blockquote>
Set the headset and controllers on the floor in the center of the playspace. Run the Quick Calibration utility from the SteamVR-Monitor (the desktop utility showing basestations, headset and controller icons) under Settings > Developer > Room and Tracking. This will setup a standing play area for you to use.
</blockquote>

If the Settings window crashes when selecting Developer, [https://help.steampowered.com/en/faqs/view/4F5E-AD22-7402-2EAD try opting into SteamVR Beta] first. When calibrated, you should switch back to the stable SteamVR (opt out of Beta).

==== Turning On Controllers Launches SteamVR ====
Why is this an issue? It may be if you happen to want to use Monado instead (explained later in this guide), as you do not want to run SteamVR and [https://lvra.gitlab.io/docs/fossvr/envision/ Envision]/Monado at the same time.

The steps to disable this are in LVRA wiki on [https://lvra.gitlab.io/docs/fossvr/monado/#steam this page]

== Why Monado/WiVRn? ==
It's simple, as SteamVR has a pile of issues, for example lack of reprojection (this means the inside of your headset will be stuttery) or otherwise general bugs and worse performance. Monado doesn't have these issues.

Monado is for wired headsets such as the HTC Vive. [https://lvra.gitlab.io/docs/fossvr/wivrn/ WiVRn] is based on Monado.

== Using Monado Instead of SteamVR with Envision ==
If you have done everything else right so far, you should be able to install Envision, which will help you setup Monado easily

$ distrobox enter --root vrbox -- sudo dnf install git envision envision-monado

With this done, simply launch Envision like so

$ distrobox enter --root vrbox -- envision

Make sure to read up on [https://lvra.gitlab.io/docs/fossvr/envision/ Envision] to know how to use it. After building a profile, it might ask you to set the right capabilities for the Monado binary, which you would do in essentially the same way as for SteamVR's binary.

== Using WiVRn Instead of SteamVR for Standalone Headsets ==
In contrast (but not really) to Monado, there's WiVRn for standalone headsets such as the Quest.
You have a few options with this, as you can continue with the Distrobox trend and install it using

$ distrobox enter --root vrbox -- sudo dnf install wivrn

And proceed to also [https://rpmfusion.org/Howto/Multimedia install required codecs].

Alternatively, you could simply not bother with Distrobox and go the [[Flatpak]] way (including Flatpak [[Steam]])

$ flatpak install io.github.wivrn.wivrn

But you will need to do extra setup as explained [https://lvra.gitlab.io/docs/fossvr/wivrn/ in the WiVRn LVRA wiki page].

== Running Additional Software for VR/XR ==
For example [https://github.com/galister/wlx-overlay-s WlxOverlay-S], which allows you to interact with your desktop inside VR.

Running it is simple, the procedure is as follows:

#Download the relevant AppImage or binary
#Move it somewhere in your container's home directory, i.e. ~/Containers/vrbox/wlx/
#Make it executable using
#*{{Cmd|$ chmod +x ~/Containers/vrbox/wlx/WlxOverlay-S-*.AppImage}}
#Run it using (use the correct path)
#*{{Cmd|$ distrobox enter --root vrbox -- ~/Containers/vrbox/wlx/WlxOverlay-S-xxx.AppImage}}

WlxOverlay-S specifically requires functional xdg desktop portals, like those seen here in [[PipeWire#Screen_sharing_on_Wayland]], and it may be important for you to setup Pipewire using its user service as showed in [[PipeWire#Pipewire_user_service]]

== See Also ==
[https://lvra.gitlab.io/ Linux VR Adventures Wiki (LVRA)]

[[Category:Gaming]]

User:Lilith

2025-09-21T11:29:09Z

Lilith: Created page with "email: lilithcat@getgoogleoff.me"

email: lilithcat@getgoogleoff.me