• HTTP-based command runner — token access, payload parameters, multiline support, configurable timeouts
• Background worker processing — async queue with real-time status tracking
• Call history — command output with auto-refresh
• Command management — regenerable tokens, custom icons, shareable URLs
• User authentication — remember me, Redis-backed sessions
• User management — CLI and web interface, Gravatar integration
• Modern UI — Vue 3, Tailwind CSS, dark/light/system theme, responsive
• Cross-platform — Linux, macOS, Windows
• Docker support — multi-architecture (amd64, arm64)
• Redis-backed storage — configurable key prefix for multi-instance use

Follow the steps below to install and configure Homettp.

• Redis: Version >= 5.0 for data storage
• /bin/sh on Linux/MacOS for command execution
• cmd.exe on Windows for command execution

Image can be found at the package page on GitHub.

docker run --rm \
-e APP_URL=http://127.0.0.1:4000 \
-e APP_KEY=$(openssl rand -hex 16) \
-e REDIS_URL=redis://192.168.0.200:6379/0 \
-p 4000:4000 \
ghcr.io/homettp/homettp

Download the latest release for your platform from the GitHub Releases page.

• Go: Version >= 1.26
• Node.js: Version >= 22.0
• Yarn or NPM

1. Clone the repository:

git clone git@github.com:homettp/homettp.git

2. Install UI dependencies and build:

cd homettp
yarn install
yarn build

3. Build the binary:

go build

4. Copy and edit the configuration:

cp .env.example .env

All configuration is done through environment variables in the .env file.

• For example generate with openssl rand -hex 16 command

APP_KEY=

APP_ADDR=:4000

APP_URL=http://127.0.0.1:4000

REDIS_URL=redis://127.0.0.1:6379/0

REDIS_KEY_PREFIX=homettp:

COMMAND_TIMEOUT=60

COMMAND_WORKER_COUNT=2

COMMAND_HISTORY_LIMIT=100

./homettp make user <username> <email> <password>

./homettp web serve

If you are facing a problem with this package or found any bug, please open an issue on GitHub.

The MIT License (MIT). Please see License File for more information.