---
title: "NeedPorts Client Commands and Uninstall Guide"
description: "Useful NeedPorts client commands for checking status, reading logs, testing assigned ports, refreshing configuration, and uninstalling the local tunnel client."
image: "https://needports.com/og-image.svg"
canonical: "https://needports.com/client-commands.html"
html: "https://needports.com/client-commands.html"
---
# NeedPorts client commands and uninstall guide

Useful commands for checking NeedPorts client status, reading logs, testing assigned ports, refreshing configuration, reinstalling the client, and uninstalling local components.

## Quick checks

```bash
needports status
systemctl status frpc
```

## Logs

```bash
needports logs
journalctl -u frpc -f
```

## Configuration

```bash
needports config
cat /etc/frp/frpc.toml
```

## Restart or stop the tunnel client

```bash
needports restart
systemctl restart frpc

needports stop
systemctl stop frpc
```

## Diagnostics and assigned-port tests

```bash
needports doctor
needports connectivity
needports probe <assigned-port>
needports selftest <assigned-port>
needports-selftest <assigned-port>
```

## Refresh or reinstall

These are maintenance commands for an already configured client. First install uses the tokenized command shown after signup/trial checkout.

```bash
curl -fsSL https://api.needports.com/install | sudo bash -s --refresh-only
curl -fsSL https://api.needports.com/install | sudo bash -s --reinstall
curl -fsSL https://api.needports.com/install | sudo bash -s --reinstall --mode selfhost
```

## Help and command list

```bash
needports help
needports commands
curl -fsSL https://api.needports.com/install | sudo bash -s --help
curl -fsSL https://api.needports.com/install | sudo bash -s --print-commands
```

## Uninstall

```bash
sudo needports uninstall
curl -fsSL https://api.needports.com/install | sudo bash -s --uninstall
```

## Related pages

- [NeedPorts guides](https://needports.com/guides.html)
- [Security model](https://needports.com/security.html)
- [Vast.ai port forwarding](https://needports.com/vast-ai-port-forwarding.html)
- [CGNAT port forwarding](https://needports.com/cgnat-port-forwarding.html)


```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "name": "NeedPorts",
      "url": "https://needports.com/",
      "@id": "https://needports.com/#organization"
    },
    {
      "@type": "Article",
      "headline": "NeedPorts client commands and uninstall guide",
      "description": "Useful NeedPorts commands for status checks, logs, diagnostics, port testing, config refresh, and local uninstall.",
      "url": "https://needports.com/client-commands.html",
      "mainEntityOfPage": "https://needports.com/client-commands.html"
    },
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "Home",
          "item": "https://needports.com/"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "Guides",
          "item": "https://needports.com/guides.html"
        },
        {
          "@type": "ListItem",
          "position": 3,
          "name": "Client commands",
          "item": "https://needports.com/client-commands.html"
        }
      ]
    }
  ]
}
```