# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.antsle.com/get-started/getting-started-with-edgelinux-software-only-version.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
