Skip to content
English
  • There are no suggestions because the search field is empty.

How to Install an OptiFleet Agent

Prerequisites

  • Make sure you have already installed Ubuntu Linux on a computer, and that you have a web browser on that machine so you can access OptiFleet during this process.
  • Make sure you have already created a site in OptiFleet.
  • Make sure you have a web browser on the Linux machine so you can go to foundryoptifleet.com
  • Note: you need an OptiFleet account with  a facility admin permission level to install an agent. 

Steps:

  1. Create an agent in OptiFleet to create the commands you will need to enter into Linux.
  2. Copy and paste the commands into the Linux command line in order.
  3. Verify the install.
  4. Troubleshooting

Create an Agent

In OptiFleet, go to Management and click into the site where you want to create an agent. If you haven’t yet created a site, you need to do so now.

In the tabs across the top of the screen, choose the second tab, Agents. Select Add Agent at the top right of the screen.

 

This window will pop up:

Add a name for the agent (your choice), and add one or more IP ranges that this agent will cover.

You can also add miner credentials here. If all your miners have the credentials admin-admin or root-root, you don’t need to enter that here, those will be handled automatically. For now you can skip this step and come back to it later if needed.

Save the agent. This will create the customized commands you need to install this agent on the Linux machine.

Locate the Commands

In OptiFleet, use the left navigation menu to go to Admin > Agents and then click into your site. Go to the Installation tab. 

Under Agent Installation, you will see three commands. You will copy each one of these, one at a time and in the order listed. Then you will copy each into Linux. (Don't copy the $ before the command, just the part that comes after that.)

Once you have copied the first command, you will need to go into Linux and be ready to copy commands into the command prompt.

Run the Commands

Now copy each of the commands into the command prompt and let each one complete before starting the next one.

Note that these commands are specific to your site, so you can't copy commands from another site and have them work here.

  • Add Foundry Debian Repository
  • Install OptiFleet Agent

Verify the Install

Run the third command to check status of the agent.

  • Optional: Check OptiFleet Agent Status

To troubleshoot, view agent logs, and stop and restart the agent, see this FAQ