4. Patches

Summary List

The following patches are included with the Proteus App Manager:

• Summary List
• Path in File Explorer
• Netplan Config
• Menu: Create Text File
• Update Host File
• Virtualbox Guest Additions Patch
  • The Problem
  • The Cause
  • The Fix

---

Path in File Explorer

This option will modify your File Browser to display the full path to your current folder, instead of selectable segments.

Original Version

Patched Version

---

Netplan Config

This patch installs a netplan template on your device by creating a new file located in /etc/netplan/50-cloud-init.yaml.

The template consists of the following:

network:
  version: 2
  renderer: NetworkManager
  ethernets:
    ${netplan_adapt_old}:
      dhcp4: no
      addresses:
        - ${netplan_ip_static}
      gateway4: ${netplan_ip_gateway}
      match:
          macaddress: ${netplan_macaddr}
      set-name: ${netplan_adapt_new}
      nameservers:
          addresses:
              - ${netplan_dns_1}
              - ${netplan_dns_2}

The following values will be injected:

• Primary network adapter will be renamed to eth0
• Static IP address assigned to network adapter
• DNS addresses will be changed to Quad9's DNS

To edit the values that are added to the template, open the setup.sh file and locate the following settings:

netplan_adapt_old=enp0s3
netplan_adapt_new=eth0

netplan_ip_static=192.168.0.10/24
netplan_ip_gateway=192.168.0.1

netplan_dns_1=9.9.9.9
netplan_dns_2=149.112.112.112

Read the comments provided in the setup.sh file near the above settings if you wish to change the DNS servers being used to another service such as Cloudflare or Google. The DNS IP addresses are provided in the installer file.

---

Menu: Create Text File

This feature comes out-of-box on ZorinOS, however, is missing on Ubuntu systems.

This patch adds a new "Text File" option in your right-click context menu.

---

Update Host File

This patch will modify your device's /etc/hosts file and add new entries based on the values specified in the config. This is useful for users who are using their machine as a host for programs like Pihole or for being able to give devices alternative host aliases.

To modify the default values, open the setup.sh file and locate:

hosts="
127.0.0.5\tdevice.name.domain
127.0.0.6\tdevice.name.domain
127.0.0.7\tdevice.name.domain
"

Ensure you leave the \t escape in place, as it represents a [TAB] that will be inserted into the file when the patch is ran. If you open your /etc/hosts file after the patch is complete, you will see the following:

127.0.0.5    device.name.domain
127.0.0.6    device.name.domain
127.0.0.7    device.name.domain

---

Virtualbox Guest Additions Patch

This patch primarily targets ZorinOS Core (non-Pro) releases and users who are running ZorinOS Core on Oracle VM VirtualBox.

The Problem

Users who install the Oracle VirtualBox Guest Additions CD image will notice that clipboard sharing will not work. Coupled with a boot issue which results in your machine taking approximately 5 minutes to start up with a message that says:

The Cause

ZorinOS Core appears to come preinstalled with two packages:

• open-vm-tools-desktop
• open-vm-tools

To confirm your system has these two packages installed, open Terminal and execute:

dpkg -l | grep virtual

Which will display the following:

There appears to be a conflict between the two preinstalled packages, and the software installed from the Oracle VirtualBox Guest Additions CD image.

When you first mount the Oracle VirtualBox Guest Additions image, you are given the prompt to install the software onto your machine:

Once your terminal opens and executes a few tasks, you will see a message similar to the following:

It should be noted that ZorinOS Pro does not have this issue. The VirtualBox Guest Additions installs and immediately works, and the two open-vm-tools packages are NOT installed on ZorinOS Pro.

The Fix

In order to fix the boot time and get clipboard sharing to work, we need to remove the two packages included with ZorinOS Core.

Launch the Proteus App Manager from this repo.

From the list of options available, select Patch: VBox Additions

Once the patch has been applied, reboot the system and you should no longer have the delayed boot issue.