> For the complete documentation index, see [llms.txt](https://help.proxidize.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.proxidize.com/legacy-products/proxy-builder/setup-and-onboarding/linux-agent-onboarding-and-offboarding-hosts.md).

# Linux Agent: Onboarding and Offboarding Hosts

Learn about how to add or remove hosts from your Proxidize cloud dashboard.

## Installation

{% stepper %}
{% step %}
Once you have an external monitor connected to the server using an HDMI cable, you'll be presented with the following screen shown in the image below, after which you need to start the onboarding of your host by navigating to the “All applications menu”

![Onboard1](/files/a1070472729fbad20886b283e14200ff568d4da6)
{% endstep %}

{% step %}
Type “Terminal” on the search field and we open the Terminal app.

![image](/files/8b48d64770226be9b98382d676bd7e16c9bf7d55)
{% endstep %}

{% step %}
Type the following command: `sudo su` and enter the user password.
{% endstep %}

{% step %}
Type the following command: `curl -fsSL [pxfile.com/install\_cloud](http://pxfile.com/install%5Fcloud) | bash`

The installation process should start, once the installation process is finished, we get an IP address and we access it from the browser.

![Onboard3](/files/790487404523baf303c672ebf6832a06ffebc332)
{% endstep %}

{% step %}
Visit the IP presented to continue setting up your host
{% endstep %}
{% endstepper %}

## Onboarding your host (basic)

{% stepper %}
{% step %}
Once you are have entered the IP of your server, you'll see the login page of the Proxidize Cloud Platform, at which you need to enter the default credentials (admin:admin)

![Onboard4](/files/c9cd53b0a15a059dd7e1a65166d6356cb435ac6e)
{% endstep %}

{% step %}
You will be presented with a EULA agreement that contains the terms of use applicable to all Proxidize software.

![Onboard5](/files/c197bec4eaa6d4c569cc0aa98a9b11015a6d1207)
{% endstep %}

{% step %}
After reading the terms and conditions of the EULA you will need to confirm that you have read and accepted the terms and conditions of the EULA.

![Onboard6](/files/8a2864c1f2b923dd582b7d68257ad8a35846ea2c)
{% endstep %}

{% step %}
Next, you will be asked to change the default password for security reasons.

![Onboard7](/files/c47396724d3d5ac4771a431e791edf36d63c68e6)
{% endstep %}

{% step %}
Sign-in using your Proxidize account on the Proxidize cloud app at [https://www.app.proxidize.com](http://pxfile.com/install%5Fcloud) where you'll be able to find the pin on your Proxidize Cloud app dashboard.

![Onboard8](/files/3b5e213d2eafe456cb023401ab51a699e19922fa)
{% endstep %}

{% step %}
You will be asked to give the configured host a nickname and to enter the PIN mentioned in step 6.

![Onboard9](/files/94c3a045598150a11170f7b5b1ddc9dfa4da7de0)
{% endstep %}

{% step %}
To configure a static IP for this host, you can tick the static IP checkbox, which will ask you for your default gateway's IP (router IP) and the IP you want to reserve for your host.
{% endstep %}

{% step %}
Visit the Proxidize cloud app to verify the onboarding process

![image (1)](/files/e159bbabb03eb46f2642f9e667c5a0926056ad79)
{% endstep %}
{% endstepper %}

## Onboarding your host (advanced)

{% stepper %}
{% step %}
If you’re onboarding your host with a static IP, check the static IP option

![image (2)](/files/8992e800743f40fd77f84ea1996ad696ffa7c72d)
{% endstep %}

{% step %}
Use the command `ip r` to get the name of your network interface name

![image (3)](/files/c40561f79f7d35a664724bf2fc1e1bb3d1e145b1)
{% endstep %}

{% step %}
Fill in the network interface name along with your host IP address, default gateway (router) and the DNS server IP address (default 8.8.8.8)

![image (4)](/files/cd6fe90d8a94f26670f90535bbe27d0011eab322)
{% endstep %}
{% endstepper %}

## Offboarding your host

{% stepper %}
{% step %}
Visit the Proxidize cloud app
{% endstep %}

{% step %}
Navigate to Dashboard, and then the hardware tab, where you will be able to see the hosts option.
{% endstep %}

{% step %}
Locate the offboard button (bin icon)

![image (5)](/files/dab30deb369bf0727d6391d26296f764f075989a)
{% endstep %}

{% step %}
Your host should be offboarded now.

![image (6)](/files/cd1b9e9686286cd1f3d5b073ffff9feb7b792909)
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.proxidize.com/legacy-products/proxy-builder/setup-and-onboarding/linux-agent-onboarding-and-offboarding-hosts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.