Enter your license

At the end of this page your license key will be in use. If you don't have a key, skip this: Ferrule runs a 30-day trial on its own.

Paste the key

1. In Ferrule, click Settings ⚙ and find License.
2. Paste the whole key into License key. It's one long line starting FERRULE1.
3. Click Apply.

The edition changes straight away, with no restart. A key that's wrong or expired is refused, with the reason, and whatever you had before stays in place.

If sign-in is turned on

Only an admin can enter a key.

What the license panel says

Online check	Means
Waiting for the first check-in	Normal for a new key. It changes to Confirmed online, usually within two hours
Confirmed online	All good. The key is checked again every day
Not confirmed online	Ferrule hasn't been able to check the key for a while. The days left are shown; see below
Withdrawn	The key has been cancelled. Ask for a new one
Offline key: never checks in	A key for a site without internet access

If it can't check in

Once a day (hourly until a new key is confirmed), Ferrule downloads a short list of cancelled keys from https://license.ferrulehq.dev/revoked. If it can't reach that address for 30 days, the paid features pause until it can. You'll get a warning a week before.

Monitoring, alerts and sign-in never stop, whatever happens to a license. Only the paid features pause.

For a site that can never reach the internet, ask for an offline key.

Without a key

• Days 1 to 30: the trial, with every feature on. The license panel shows the days left.
• After that: Community, free for personal use, with everything for one site. The paid features are listed on the license panel.

Can I put the key in my settings instead?

Yes: set FERRULE_LICENSE with your other settings, in Portainer or in .env. A key set there always wins, and the box on Settings is locked.