Distribution & Licensing

Distribution & Licensing

Instruct users to install and update your command-line application

Licensing and distributing your Terminalwire app is designed to be as easy and as low friction as possible. There’s basically two things you need to do to distribute your app:

  1. Acquire a license
  2. Distribute the app

Get a license

Terminalwire Server is proprietary software that requires a license to run in production. You can get a license by signing up for a Terminalwire account and requesting a license with the URL of your web application.

Licenses are free for projects with under $100,000/year in revenue or for organizations with under $1,000,000 in gross assets. This makes them perfect for personal projects, hobbies, or startups that are just getting off the ground. If you’re an established larger organization, you’ll need to purchase a commercial license, which starts at $99/month.

Licenses can be obtained from the Terminalwire account page or the command-line.

Request a Pro license for a commercial web application
terminalwire license request https://mega-corp.example.com/terminal \
  --product pro
Request a Core license for a personal application
terminalwire license request https://hobbyist.example.com/terminal \
  --product core

If a commercial license is requisted from the command line, the browser will open to collect payment.

Distribute the app

Once you have a acquired server license, you can distribute your app to users. There are two main ways to distribute your app:

  1. Terminalwire directory
  2. One-off installations by URL

You’ll want to make sure you have a license before distributing your app to users; otherwise they’ll see a warning message that your server is not licensed when they run the app.

Terminalwire directory

The application directory makes it possible for users to install your app via terminalwire install my-app. You can list your Terminalwire application from the Distribution Dashboard or by running the following command:

Creates a distribution for the app at https://example.com/terminal
terminalwire distribution create my-app \
  --url https://example.com/terminal

Your users may then install this app by running:

How customers install your app
terminalwire install my-app

Distributions listed in the directory appear on Terminalwire.com/applications and include an installation page you can share with your customers, like this installation page for TinyZap.

One-off installations by URL

Terminalwire applications may be installed by running:

terminalwire install \
  --url https://example.com/terminal \
  --name my-app

This creates the same binary file as the application being installed from the Terminalwire directory and places it in ~/.terminalwire/bin/my-app. The user can then run my-app to start the application.