Getting started with edgeLinux

Bare-Metal Hardware

Installing edgeLinux on Bare-Metal Hardware

1. Put edgeLinux iso onto USB

You can download edgeLinux from here. It is currently in a closed beta so you'll need your invite code and the email your invite code was sent to download. After you have downloaded the edgeLinux iso, you will need a fresh USB stick with as much space as the size of the iso file.

You then want to use a flash image tool such as Etcher, to flash the iso image to your USB (please note this will erase all data on the USB).

Once you have done that you can eject that and insert it into your bare-metal server/desktop/laptop. Your machine should ideally also have connection to the internet, preferably via ethernet.

2. Boot from USB and Install edgeLinux

You can now start up your bare-metal machine, and get into the boot options. How you do that varies from machine to machine, but you will likely see a message to hit the Delete or F12 key to get into the boot options when your machine first starts. You can use either Legacy Boot or UEFI Boot, both are supported by edgeLinux, but generally UEFI is more desirable. Please select to boot of the USB. Your boot options should look something like this:

The edgeLinux installer should boot and then you will see the edgeLinux welcome page:

You should see all the system checks passed. If not, should see a warning about your RAM, your CPU, or your Internet connection.

Select Done and Install edgeLinux. You will need to select the network connection, this again will vary by your machine, but usually the default is good and you can just hit Done.

You can then select Use An Entire Disk and pick which drive you want to install edgeLinux on. Please note this will erase the data on this drive.

If you wanted to just try edgeLinux and keep your data, you can insert a second USB (over 17GB) and install it on that.

You then want to review the Filesystem setup, which should look like below and select Continue.

You can then create a user in the Profile setup, please be sure to use the email address where you received your invite code.

edgeLinux will start installing. :)

After installation you can select Reboot Now. Then when prompted unplug the USB (installation medium).

3. Start using edgeLinux!

Now when you reboot your machine, get back into the boot options and select the drive where you installed edgeLinux.

You should then see edgeLinux boot and can then login with the user you created in the installer.

Congratulations! You now have edgeLinux!



Recommended but optional:

If you want to manage your antlets (virtual servers) with a GUI, you can input <your-hostname>.local (in this case edgelrose.local) into your favourite web browser and login to antMan. You can also input your IP followed by port 3000.

You can then login with the same user you created in the installation and start managing your antlets with the antMan GUI!

VMware Fusion (Macs)

Installing edgeLinux on VMware Fusion (Macs)

1. Create and Configure New VM

You can download edgeLinux from [here] (https://edgelinux.org/download/). It is currently in a closed beta so you'll need your invite code and the email your invite code was sent to download the .iso file.

To ge VMware Fusio, you can download the trial version from here. Then follow the few simple prompts to get it installed.

Once VMware Fusion is running, click on the + symbol in the top right, then click on New...

Then select Install from disc or image and drag drop the edgeLinux.iso from your Downloads folder.

After clicking Continue, on the Choose Operating System page, choose Linux and then Other Linux 4.x or later kernal 64-bit

Important: Click Continue, then under Specify the boot firmware: you can use either Legacy BIOS or UEFI, both are supported by edgeLinux, but generally UEFI is more desirable. Click Continue.
Under the Finish section click Customize Settings. Call the VM whatever you prefer and save. This will then open the VM console and the VM settings like in the picture below.
Recommended but optional: From here if you want to run KVM antlets, not just LXC antlets you can click on Processors and Memory, then Advanced options, then check the box Enable hypervisor applications in this virtual machine.

Recommended but optional: Also in Processors and Memory you can allocate resources. edgeLinux recommends a minimum of 2GB RAM, and VMware usually defaults to 1024MB, so you will want to change that to at least 2048 MB. You can also allocate the number of processors.

Back in the main setting menu, you can click on Hard Disk (SCSI) to allocate more disk space. We recommend at least 50GB for testing.

2. Start VM and Install edgeLinux

Click the big play icon on the VM console and see edgeLinux bootup.

On the Welcome to edgeLinux! screen you should see all the system checks passed. If you instead see a warning on the RAM check or the vitualization check, you likely skipped one of the Recommended sections above, however you can still run edgeLinux with these warnings.

Select Done and Install edgeLinux. You will need to select the network connection, but usually the default is good and you can just hit Done. You can then select Use An Entire Disk and /dev/sda, which should be the storage you allocated back in the Hard Disk (SCSI) Settings.

You then want to review the Filesystem setup, which should look like below and select Continue.

You can then create a user in the Profile setup, please be sure to use the email address where you received your invite code.

edgeLinux will start installing. :)

After installation you can select Reboot Now. The iso (installation medium) should be remove automatically after reboot.

3. Start using edgeLinux!

When rebooting and when prompted by VMware Fusion input your Mac password to monitor network traffic.

You can then login with the user you created in the installer.

Congratulations! You now have edgeLinux!



Recommended but optional:

If you want to manage your antlets (virtual servers) with a GUI, you can input <your-hostname>.local into your favourite web browser and login to antMan. You can also input your IP followed by port 3000 (see below).

You can find your IP by typing ifconfig br0 in the command line. Your IP is under inet, for example in the picture th IP is 172.16.224.144

You can then login with the same user you created in the installation and start managing your antlets with the antMan GUI!

VMware Workstation Player (Windows and Linux)

Installing edgeLinux on VMware Workstation Player (Windows and Linux)

In detail tutorial coming soon!

You can download edgeLinux from here. It is currently in a closed beta so you'll need your invite code and the email your invite code was sent to download the .iso file.

You can download the trial version of VMware Workstation Player from here. And the installation process is very similar to the above Installing edgeLinux on VMware Fusion (for Macs)

VirtualBox

Installing edgeLinux on VirtualBox

Please note before you start:
VirtualBox does NOT support nested virtualization, hence you will not be able to run KVM antlets with VirtualBox. You will still be able to run LXC antlets however :)

1. Create and Configure New VM

You can download edgeLinux from here. It is currently in a closed beta so you'll need your invite code and the email address your invite code was sent to download the .iso file.

First download the latest version of VirtualBox from here.

Once installed create a new VM and select the type and version as shown below:

Then select the amount of RAM you want to allocate to the VM, we recommend at least 2048MB Then select "Create a virtual hard disk now", click "Create". At the bottom of the screen click "Expert Mode", then choose the file type "VDI (VirtualBox Disk Image)" and your disk size, we recommend at least 25GB for testing with LXCs.

When the VM is created click on "Settings", then "Network", then change "Attached to: " from "NAT" to "Bridged Adapter" and click "OK".

Now start the VM up and select the edgelinux.iso.

Note when the installer boots up it will tell you that this CPU does not support virtualization. This is because VirtualBox does not support nested virtualization, hence you will not be able to run KVM antlets, but you can still run super lean linux LXC antlets!

Select Done and Install edgeLinux. You will need to select the network connection, but usually the default is good and you can just hit Done. You can then select Use An Entire Disk and VBOX_HARDDISK_VBXXXXXXXX-XXXXXXXX.

You then want to review the Filesystem setup, which should look like below and select Continue.

You can then create a user in the Profile setup, please be sure to use the email address where you received your invite code.

edgeLinux will start installing. :)

After installation you can select Reboot Now. The iso (installation medium) should be remove automatically after reboot.

3. Start using edgeLinux!

You can then login with the user you created in the installer.

Congratulations! You now have edgeLinux!



Recommended but optional:

If you want to manage your antlets (virtual servers) with a GUI, you can input <your-hostname>.local into your favourite web browser and login to antMan. You can also input your IP followed by port 3000 (see below).

You can find your IP by typing ifconfig br0 in the command line. Your IP is under inet, for example in the picture th IP is 172.16.224.144

You can then login with the same user you created in the installation and start managing your antlets with the antMan GUI!