Install FF1 Master
Deploy FF1 Master with the official script in production, and safeguard secrets such as FF1_SECRET_KEY.
Prerequisites
Section titled “Prerequisites”- A Linux server that meets the requirements (data uses embedded SQLite, no separate database needed)
- A License Key obtained by claiming the Community edition or purchasing on the website (see License Activation)
One-click install
Section titled “One-click install”The install command is delivered with your license and is not published in the docs. Get it one of two ways:
- Check the activation email for the install instructions; or
- Sign in to the Account Center → My Licenses and copy the install command.
Then run it as root. The script will:
- Download and install FF1 Master, writing config to
/etc/ff1/ - Generate the master secret
FF1_SECRET_KEYon first run (not overwritten on upgrade — be sure to back it up offline) - Generate an admin account (
FF1_ADMIN_USERNAME/FF1_ADMIN_PASSWORD); save the credentials as prompted by the script - Initialize the embedded SQLite data (stored in the data directory, no external database required)
- Register and start the
ff1-mastersystemd service
Key configuration
Section titled “Key configuration”| Item | Description |
|---|---|
/etc/ff1/ | Config directory (service port, data directory, feature toggles) |
FF1_SECRET_KEY | Encryption master secret; losing it makes stored data undecryptable — must be backed up |
FF1_HTTP_ADDR | Master listen address, default :80 |
FF1_PUBLIC_URL | Public-facing address, used to populate provisioning scripts |
Restart after changing config:
sudo systemctl restart ff1-masterHTTPS and reverse proxy (recommended)
Section titled “HTTPS and reverse proxy (recommended)”For production, front Master with Nginx / Caddy to terminate TLS and reverse-proxy to Master’s listen port. The console and provisioning wizard use the browser origin as the public-facing address.
Verify
Section titled “Verify”- Open the Master address in a browser and sign in with the admin account
- The console home page shows license status and version
- Go to License Activation and enter your License Key
Q: Startup fails / data directory error? A: Confirm the data directory is writable and the disk is not full; the SQLite data file is created automatically with the service — no manual database creation needed.
Q: Forgot the admin password?
A: You can reset it by setting FF1_ADMIN_USERNAME / FF1_ADMIN_PASSWORD and restarting the service (refer to the install script help).