> 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/advanced-configuration/keeping-your-proxidize-linux-agent-up-to-date.md).

# Keeping Your Proxidize Linux Agent Up to Date

Learn how to manually update the Proxidize Linux Agent on your local server.

### What Is the Proxidize Linux Agent?

The Proxidize Linux Agent is the software installed on your local Linux server.

It is responsible for:

* Managing the USB modems connected to the server.
* Creating and managing local proxy endpoints.
* Communicating with the Proxidize Cloud Dashboard.
* Providing a local dashboard for troubleshooting and local management.

The Cloud Dashboard at [app.proxidize.com](https://app.proxidize.com/) is updated automatically by Proxidize. The Linux Agent runs on your own server, so it may need to be updated manually.

***

### Why Keep the Linux Agent Updated?

Linux Agent updates may include:

* Stability improvements.
* Security improvements.
* Bug fixes.
* New features.
* Compatibility improvements for supported hardware.
* Improvements requested by customers.

Keeping the Linux Agent updated helps your Proxy Builder setup stay stable and compatible with the latest Proxidize platform changes.

***

### Before You Start

Make sure you have:

* Access to the Proxidize server terminal.
* The server's Linux user password.
* A stable internet connection on the server.
* Enough free storage on the server.

The update may temporarily restart services or interrupt local dashboard/proxy availability.

If you are not sure whether your server meets the requirements, see [Linux Agent: System Requirements & Supported Modems](broken://pages/7fdc84561ace54a0b81cf5b433c42bfd97130169).

{% stepper %}
{% step %}

## Open a Terminal on the Proxidize Server

You can update the Linux Agent from a local terminal or over SSH.

{% tabs %}
{% tab title="Open Terminal Locally" %}
Use this option if you have a monitor, keyboard, and mouse connected to the Proxidize server.

1. Connect a monitor to the server using HDMI.
2. Open the applications menu.

![](/files/e147f1dcae0aa154b430a90c2b48738c19412bf0)

3. Search for **Terminal**.
4. Open the Terminal app.

![](/files/4454ffe4df6649b64f83919e72f91db7a73733bf)
{% endtab %}

{% tab title="Connect Over SSH" %}
Use this option if SSH access is enabled and you know the server's local IP address.

From another computer on the same network, open a terminal and connect to the server:

```bash
ssh username@server-ip-address
```

Example:

```bash
ssh proxidize@192.168.1.25
```

Replace `username` and `server-ip-address` with the correct Linux username and local IP address for your Proxidize server.

If you are not sure how to find the server IP address, see [Understanding Public IPs, Private IPs, and Your Router IP Address](broken://pages/c4d4f58151a500552596dd3acd9588521eef94aa).
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

## Check Available Storage

Before updating, check that the server has enough free storage:

```bash
df -h
```

If the disk is full or almost full, free storage before continuing. Low storage can cause updates to fail or services to behave unexpectedly.
{% endstep %}

{% step %}

## Switch to Root User

In the terminal, run:

```bash
sudo su
```

Enter the Linux user password when prompted.

After switching to root, your terminal prompt may change from `$` to `#`.
{% endstep %}

{% step %}

## Run the Linux Agent Update Command

Run the following command:

```bash
curl -fsSL https://pxfile.com/install_cloud | bash
```

The update process will start automatically. Wait for it to finish.

Do not close the terminal or power off the server while the update is running.
{% endstep %}

{% step %}

## After the Update Completes

When the update is complete, the installer should show the local IP address you can use to access the Linux Agent again.

Open the local dashboard in your browser using the server's local IP address.

Example:

```
http://192.168.1.25
```

If your setup uses a different dashboard port or custom access method, use the address configured for your environment.
{% endstep %}

{% step %}

## Confirm the Linux Agent Is Working

After updating:

1. Open the local dashboard.
2. Confirm the dashboard loads.
3. Confirm the host appears online in the Cloud Dashboard.
4. Confirm connected modems or endpoints start appearing normally.
5. Test a proxy if needed.
   {% endstep %}
   {% endstepper %}

***

### Troubleshooting

| Issue                                          | What to Check                                                                              |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------ |
| The update command does not run                | Confirm the server has internet access and DNS is working.                                 |
| sudo su asks for a password                    | Enter the Linux user password for the server account.                                      |
| Permission denied                              | Confirm your Linux user has sudo permissions.                                              |
| The update fails partway through               | Check available storage, internet connection, and rerun the command.                       |
| The local dashboard does not open after update | Confirm the server IP address, local network connection, and service status.               |
| Host does not appear online in Cloud Dashboard | Confirm the server has internet access and wait a few minutes for reconnect.               |
| Proxies do not work after update               | Confirm modems are online, SIMs have data, and the endpoints are visible in the dashboard. |

***

#### Related Articles

* [Proxidize Proxy Builder Overview & How It Works](broken://pages/adf7f36c09a9f5569cdec750dfaaf74ecd4470ec)
* [Linux Agent: System Requirements & Supported Modems](broken://pages/7fdc84561ace54a0b81cf5b433c42bfd97130169)
* [Linux Agent: Onboarding and Offboarding Hosts](broken://pages/855fc09941f7f88a5a026314171284f0e955d554)
* [Ensuring the Best Endpoint Uptime](broken://pages/bdfbeb853174af5ac2be76168ce9bef90dc69848)
* [Understanding Public IPs, Private IPs, and Your Router IP Address](broken://pages/c4d4f58151a500552596dd3acd9588521eef94aa)

***

### Need Help?

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at <support@proxidize.com>.


---

# 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/advanced-configuration/keeping-your-proxidize-linux-agent-up-to-date.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.