---
title: Command-over-HTTP
url: https://www.tines.com/docs/admin/command-over-http/
updated: 2026-02-19T20:44:15+00:00
---

*[tines.com](https://www.tines.com/llms.txt) › [Docs](https://www.tines.com/llms.txt) › [Admin](https://www.tines.com/llm/docs/admin.md)*

# Command-over-HTTP

*[View on tines.com](https://www.tines.com/docs/admin/command-over-http/)*

> **NOTE:** Not seeing this feature? Talk to your tenant admin or [reach out to the Tines team](https://www.tines.com/contact-support/) to learn more.

Command-over-HTTP allows your Tines tenant to make programmatic calls to systems running on your private network, which may not have HTTP interfaces.

It is deployed as a container service within your network, and has the capability to execute **python**, **bash**, and **powershell** scripts there.

# Deployment

Command-over-HTTP is available with the tunnel add-on option for cloud customers, and included for self-hosted customers. To get started, [reach out to us](https://www.tines.com/contact-support) and we will enable for your tenant.

Once enabled, visit `https://<your-tenant-domain>/admin/command-over-http` to obtain your deployment credentials. Only tenant owners or users with the `TUNNEL_MANAGE` tenant permission can access this page.

The container can be run through various orchestration platforms, for example Docker:

```bash
docker run \
  -d \
  --name command-over-http \
  --env TINES_TUNNEL_SECRET="secret" \
  tines/command-over-http:latest
```

For self-hosted customers, this can be configured without the TINES_TUNNEL_SECRET variable to communicate within your hosted platform setup and not via Cloudflare.

```bash
docker run \
  -d \
  --name command-over-http \
  tines/command-over-http:latest
```

# Usage

Once enabled and deployed, use the [HTTP request action](https://www.tines.com/docs/http-request/) to call the module. To do this, enable the `‘use tunnel’` parameter, and target the special URL https://command-over-http/run.

Finally, pass a JSON payload containing two keys: 1) `executor` (`python3`, `powershell`, or `bash)` and 2) `script` (the command or script you want to execute).

If you do choose to override the hostname when running the container, ensure the tenant can reach the container at the correct hostname via the HTTP action.

![](https://www.datocms-assets.com/55802/1694716924-screenshot-2023-09-01-at-10-39-36-am.png)