Close

VeltOS Installation

There are multiple ways you can try out VeltOS. Pick one that best suits you.

Please remember to backup your system before installing VeltOS. You are installing this software at your own risk.

Add VeltOS to an existing Arch Linux Installation

If you’re already running Arch Linux, you can install VeltOS using our installation script.

  1. Get an internet connection. Connecting to the internet on a clean Arch Linux installation can be tricky depending on your network setup. If you’re unsure, try these links for assistance with WiFi, or this link for a wired network.

  2. Download and run the installation script.

    Before running the commands below: you must have sudo permissions to install. Note that the -fO has the capital letter O, not zero. To make sure the script downloaded correctly before running it, you can verify the sha1hash matches bc78ea9b7e01573791042a8b919e109b88bc3a0d.

    Now run the following commands in any bash terminal:

    curl -fO https://velt.io/vosinstall.sh
    chmod +x vosinstall.sh
    sudo ./vosinstall.sh


That’s it! VeltOS is installed. If you are running in an existing desktop environment, such as the GNOME Shell, you will need to logout and select “Graphene Desktop” from the login prompt’s desktop environment selection.

Run VeltOS in a virtual machine

If you’re just interested in seeing VeltOS for yourself, but you don’t want to install it yet, running a virtual machine is for you. Here’s the step-by-step process:

  1. First, install the free virtualization software VirtualBox. Visit www.virtualbox.org and download the 64bit version of VirtualBox for your current operating system (Linux, Mac, Windows).

  2. Setup a new virtual machine with no virtual hard drive. Open VirtualBox, and click New in the top menu. Name your machine what you want, select Linux as the Type, and Arch Linux (64 bit) as the Version. Click Next. Select the amount of RAM you want (we recommend at least 1024MB/1GB). Click Next. Select Do not add a virtual hard drive. Click Create. Click Continue on the “no virtual hard drive” warning popup.

  3. Select your new virtual machine in the sidebar on the left, and click Start in the top menu. A new window should open, with a popup asking to select a “virtual optical disk file.” Click the folder icon and navigate to the VeltOS .iso file you downloaded (click here to download). After selecting the ISO, click Start. Wait a few seconds. When the boot selection dialog appears, using the arrow keys, select Boot Arch Linux (x86_64) and press Enter. The machine should begin to boot into VeltOS.

Note that since VeltOS is not installed, no data you create will be saved. Restarting the machine will erase all changes you make. However, if you choose “Save Machine State” when closing the virtual machine, VirtualBox will reopen where you left off next time you launch your VM.