# edgeLinux Installation

{% hint style="success" %}
If you've come here because you are setting up an Antsle server you just bought, edgeLinux is already installed. You can read about how to [set up the](https://docs.antsle.com/setup) [Antsle one](https://docs.antsle.com/setup) or [Antsle Nano](https://docs.antsle.com/setup-nano) for the first time.
{% endhint %}

## **Install edgeLinux on Intel / AMD Architecture**

### **1. Install ISO**

### 2. Access antMan

### 3. Activate your Server on antHill

### 4. Use antMan

## **Install ISO**

#### 1. Put ISO onto USB

Download the ISO [**here**](https://antsle.com/products/antmanedgelinux/download/) or with your antHill account at [**anthill.com**](https://anthill.antsle.com/)

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](https://www.balena.io/etcher/), to flash the iso image to your USB (please note this will erase all data on the USB).

![](https://2204297924-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LykQfPew0YJZLWKBUYz%2F-M7Uc8TDPrGehdL7Jebn%2F-M7UcVT3zktSxvYCwhBf%2Fetcher-edgelinux-iso.jpg?alt=media\&token=afb22507-b11c-4889-b62c-3d5195463a5f)

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**

Watch our video with instructions as you go through the installation: \
\
[**Watch the Install Video**](https://www.loom.com/share/3881ee11902f47eeb81d4f548f908096)[**.**](https://antsle.us16.list-manage.com/track/click?u=67fb0a69c97ce889a53356aaa\&id=b46e00d17d\&e=b1d793750b)&#x20;

{% hint style="danger" %}
Stop! Watch the video above. Really. It'll save you from making some common mistakes in the install.

Do not configure a static IP during the installation. You can configure a static IP address in the antMan management dashboard after installation.&#x20;
{% endhint %}

\
If you do not have a connected keyboard and monitor you may install via IPMI. Follow the instructions [here](https://docs.antsle.com/setup#4.-ipmi-optional).

**3. Important Highlight from** [**Video**](https://www.loom.com/share/3881ee11902f47eeb81d4f548f908096)**: Partition Your Drives (See Minute 1:45)**

Make sure that your root partition is not too big. We recommend taking the default partitions created. Ideally it looks like the following&#x20;

* 512 or 1024 MB for boot (/boot)
* 16 GB for Root (/)

Leave the rest unpartitioned. The edgeLinux installer will use the unpartitioned space for the antlets zpool (zfs storage pool).&#x20;

**4. Log in Using your Root Password and complete the installation**&#x20;

Log in with the root password that you set up and you should see the installer continue to progress.

After this it will complete the installation and ask to reboot. &#x20;

Before logging in to antMan for the first time run the command `upgrade-antman` from the command line to make sure you are at the latest version.

## Access antMan

**Are you a Windows user? Install Bonjour Print Services or iTunes.** [**See why.**](https://antsle.com/forum/topic/did-windows-10-update-1803-break-bonjour-local-addresses/)\
\
You should be able to access antMan right now at [http://YOUR\_IP:3000](http://your_ip:3000) or <http://myantsle.local>.\
\
You can use your web browser to control your Antsle server. (IE and Edge are NOT recommended).

Login with username: 'root' and the password you chose during installation.

![](https://2204297924-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LykQfPew0YJZLWKBUYz%2F-LzmC2RAsxXjyoBguGhv%2F-LzmCKFV0G8OuwnU3VGn%2Fimage.png?alt=media\&token=6aaa4322-1129-4394-9d2a-127347185e36)

#### On-boarding

You should now be presented with the on-boarding screen:

![](https://2204297924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LykQfPew0YJZLWKBUYz%2Fuploads%2FTTCbg97sk1uK14nuEZX6%2FOnboarding-3-options-b.png?alt=media\&token=a0268f34-6e7f-41f7-88a6-cdfd43ffe030)

Choose "New install on my own hardware". If you are reinstalling edgeLinux on antsle hardware or on your own hardware, choose "Reinstall with existing serial number".

Follow the on-boarding instructions. After you finish the onboarding process, wait a few minutes for antMan to restart.

## Use antMan

Go to **http\://\<myantslename>.local**\
If you have an antsle.us subdomain use **https\://\<mysubdomain>.antsle.us**

Trouble getting the login screen? Try adding port 3000 to the URL: Use **http\://\<myantslename>.local:3000**,  or if you know the IP address: **<http://x.x.x.x:3000>**

![](https://2204297924-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LykQfPew0YJZLWKBUYz%2F-LzmC2RAsxXjyoBguGhv%2F-LzmCPXNffqJKU4gB5Y0%2Fimage.png?alt=media\&token=01c8f033-1149-4235-ba17-bc24cca924f1)

Use antMan™ (antlet manager) to create a few antlets.

{% hint style="info" %}
When your server is on, it will periodically send a "heartbeat" signal to our servers so that you can see it in antHill. (You can turn this feature off in antMan Services once the server is activated, if you so choose).&#x20;
{% endhint %}

## **That’s it***,* **you are done!**&#x20;

*Go do great things with your private cloud!*  🙂

**Some exciting videos** are next! We invite you to watch our popular [FreedomCasts](http://go.antsle.com/freedomcasts). They will show you in an entertaining manner how **easy** it is to master some real-life situations with your new Antsle.

Problems? Check our [troubleshooting](https://docs.antsle.com/troubleshooting) page or write <support@antsle.com>. <br>

## Optional: Install from .iso remotely via IPMI

{% hint style="info" %}
This assumes you are using the IPMI available in Antsle servers. Your experience may be different if you are using 3rd party hardware.&#x20;
{% endhint %}

1. [**Connect to the IPMI**](https://docs.antsle.com/setup#4-ipmi-optional)**.** You can view the Antsle server's console and power up/down the antsle from the IPMI - Remote Control > iKVM/HTML5.<br>
2. Mount the installation .iso from a CIFS share via the IPMI - Virtual Media > CD-ROM Image Enter the connection details to the Share/install.iso and 'Mount' it.<br>
3. Now you can power on the antsle via the iKVM/HTML5 and it should boot to the .iso You may need to hit F11 during POST to invoke the boot menu. Choose the Virtual CDROM.<br>
4. Run through the installer and follow the video from[ step 1](https://docs.antsle.com/get-started/getting-started-with-edgelinux-software-only-version#1-install-iso)

![](https://2204297924-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LykQfPew0YJZLWKBUYz%2F-M8Hqx-VF4IXDZGWwnYH%2F-M8HswAI25GoKk-VyLNm%2FIPMI-virtual-media.png?alt=media\&token=533c4504-4dd4-44f0-ae95-13649e35665a)
