🥢 Tofuhub CLI

Tofuhub helps you deploy and manage open-source platforms with one command.

📦 Installation

npm install -g tofuhub
# or just run with npx
npx tofuhub <command>

🧭 Commands

🔐 login

Authenticate your CLI session via browser.

tofuhub login

This will open a browser window where you can authenticate. Your credentials are stored locally.

🚪 logout

Clear your local session.

tofuhub logout

This removes the stored authentication token from your machine.

🧑‍💼 whoami

Check your current session.

tofuhub whoami

Displays the currently logged-in user.

🚀 deploy <package-name>

Deploy a package to your cloud provider.

tofuhub deploy chirpstack

Tofuhub will:

• Ask for required variables (e.g. API tokens, passwords)
• Deploy infrastructure using OpenTofu
• Show logs and progress in real time

💥 destroy

Tear down an existing deployment in the current folder.

tofuhub destroy

Tofuhub will:

• Use saved state + variables
• Destroy your cloud resources
• Clean up local deployment files

💥 init

Initialise a tofuhub package

tofuhub init

Tofuhub will:

• Create a tofuhub.json file
• Create a .gitignore file

📤 publish

Publish your own package to Tofuhub.

tofuhub publish

This will:

• Prompt for metadata (name, description, etc.)
• Package your .tf files, README, and variables
• Push them to the Tofuhub registry

You must be logged in to publish.

🛠️ Requirements

• Node.js 18+
• Git (for publish)
• A supported cloud provider (e.g., DigitalOcean)

🌱 Want to contribute?

Create a deployable open-source stack? Join the community and help grow the ecosystem.