edgeLinux Installation

antMan runs on our lightweight edgeLinux OS. Once you've installed edgeLinux on your server you can then log into antMan.

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 Antsle one or Antsle Nano for the first time.

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 or with your antHill account at anthill.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, 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

Watch our video with instructions as you go through the installation: Watch the Install Video.

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.

If you do not have a connected keyboard and monitor you may install via IPMI. Follow the instructions here.

3. Important Highlight from Video: 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

  • 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).

4. Log in Using your Root Password and complete the installation

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.

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. You should be able to access antMan right now at 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.


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

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

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

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

That’s it, you are done!

Go do great things with your private cloud! 🙂

Some exciting videos are next! We invite you to watch our popular 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 page or write support@antsle.com.

Optional: Install from .iso remotely via IPMI

This assumes you are using the IPMI available in Antsle servers. Your experience may be different if you are using 3rd party hardware.

  1. Connect to the IPMI. You can view the Antsle server's console and power up/down the antsle from the IPMI - Remote Control > iKVM/HTML5.

  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.

  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.

  4. Run through the installer and follow the video from step 1

Last updated