License Activation

Overview

Docker installations use a license server that runs on your host machine (not in a container or VM). You'll need your license key and the host machine ID.

How Licensing Works

You need to install a license server on the host machine where your TOMMY Docker container runs. It must be the actual host machine, not a VM or container running on the host.

The license server provides one license that can be used by a single Docker container at a time. You can add and remove containers as needed, as long as they run on the same host machine.

The license server is a lightweight service designed with minimal resource requirements.

Host Machine Required

The license server must run on the actual host machine, not a VM or container.

License Binding

Once activated, the license is bound to this host machine and can't be transferred to another machine. Contact info@tommysense.com for special cases.

Activation Steps

Find Your Host Machine ID

Download and run the machine ID tool on your host:

AMD64:

wget https://files.tommysense.com/tools/machine-id-linux-amd64
chmod +x machine-id-linux-amd64
./machine-id-linux-amd64

ARM64:

wget https://files.tommysense.com/tools/machine-id-linux-arm64
chmod +x machine-id-linux-arm64
./machine-id-linux-arm64

Copy the machine ID that's displayed.

Activate Your License

Go to the activation portal:

Select Docker Installation
Enter your license key and machine ID
Accept the terms and activate

This compiles a machine-specific license server. The process takes a few minutes - don't refresh the page. You'll get download URLs for the .deb package when it's done.

Download License Server Package

Download the .deb package using the URL from the activation portal:

wget <download-url-from-activation-portal>

Install License Server

Install the .deb package:

sudo dpkg -i <downloaded-deb-filename>

Configure License Server

Add these environment variables to ~/.profile or ~/.bashrc:

export TOMMY_LICENSE_SERVER_HOST="localhost"
export TOMMY_LICENSE_SERVER_PORT="6349"
export TOMMY_LICENSE_KEY="your-license-key-here"

Reload: source ~/.profile (or source ~/.bashrc)

Start License Server Service

Restart the service:

sudo systemctl restart tommy-license-server

Check status: systemctl --user status tommy-license-server
View logs: journalctl --user -u tommy-license-server -f

Configure Docker Container

Add the license server host and port to your container. In your Docker run command:

-e TOMMY_LICENSE_SERVER_HOST=localhost
-e TOMMY_LICENSE_SERVER_PORT=6349

Or in docker-compose.yml:

environment:
  - TOMMY_LICENSE_SERVER_HOST=localhost
  - TOMMY_LICENSE_SERVER_PORT=6349

Restart Docker Container

Restart your container:

docker restart tommy

Or with docker-compose: docker-compose restart

Uninstalling the License Server

To remove the license server:

sudo dpkg -r tommy-license-server

This will automatically stop and disable the service.

To completely remove all configuration and user files:

sudo dpkg --purge tommy-license-server

Note: You may want to manually remove environment variables from ~/.profile or ~/.bashrc.

Troubleshooting

Activation errors:

"Machine count exceeded" - License is already bound to another machine
"License data not returned" - Check your license key or contact info@tommysense.com
Transient errors - Wait a few minutes and try again

License server issues:

Service won't start - Check environment variables are set correctly
Can't connect - Verify port 6349 is accessible from container
Port conflicts - Change TOMMY_LICENSE_SERVER_PORT if 6349 is in use

Container can't reach license server:

Ensure TOMMY_LICENSE_SERVER_HOST and TOMMY_LICENSE_SERVER_PORT are set in container
Ensure container can reach host on the specified host and port (default: localhost:6349)
Check firewall rules

Need help? Contact info@tommysense.com with your license key (first/last 4 chars), machine ID, and error messages.

License Activation - Docker