cloudron-httpn

httpn express server packaged to run as a cloudron app.

The app is not yet in the Cloudron App Store so for now you have to use the Cloudron CLI to install.

Prerequisites

Install the Cloudron CLI - npm install -g cloudron

Installation

# Authenticate the CLI with your Cloudron instance
cloudron login your.instance.com

# Clone the project and change into it
git clone https://git.nostrdev.com/stuff/cloudron-httpn
cd cloudron-httpn

# Install latest version
cloudron install --image git.nostrdev.com/stuff/cloudron-httpn:latest -l httpn.YOURDOMAIN.com

Run locally

# Run locally with additional configuration
run-local.sh

Docker Image Versioning

The Docker images for this project are automatically tagged with:

1. latest - Always points to the most recent build
2. Version tag (e.g., 1.0.0) - Matches the version of @nostrdev/httpn-cli used in the image

This allows you to pin your installation to a specific version of the underlying @nostrdev/httpn-cli package for stability, or always use the latest version.

Automatic Startup

The service automatically starts when the Docker container runs. The startup process:

1. Extracts and displays the @nostrdev/httpn-cli version being used
2. Locates the secret key from environment variables or mounted secrets
3. Starts the HTTPN service on port 8000
4. Exposes the service via Cloudron's reverse proxy

Cloudron Manifest

This application includes a CloudronManifest.json file that provides Cloudron with all the necessary information about the application. After installation, you'll need to configure the required HTTPN_SECRET_KEY and HTTPN_RELAYS environment variables through the Cloudron dashboard.