HF PanelDocsv1.0.0

Customise the installation

Every installer option, unattended installs without questions, and how to change the same things after installing.

Give the installer options to answer its questions in advance, choose the panel port, or leave parts out. Options go after bash latest.

Options

Option What it does Default
--licence KEY your licence key, so the installer doesn't ask (--license works too) asked
--hostname NAME the server's own name, for example panel.yourdomain.com. The domain after the first dot is used for every other address asked as Domain, then panel. + your domain
--email ADDRESS the administrator's email: SSL notices, alerts, the "server is ready" email asked
--company "NAME" the company name in email footers and sender names your domain's first part, with a capital
--port PORT the panels' port 8443
--ns1 NAME, --ns2 NAME your nameservers' names ns1. and ns2. + your domain
--mail-host NAME the mail server's name: the MX, the name it greets other servers with, and the reverse DNS mail. + your domain
--node VERSION the Node.js version for customers' apps: a major version, 18 or newer (for example 22) 24
--quotas hard disk quotas per account on the / filesystem off
--no-mail no email: no Postfix, Dovecot, spam filtering or webmail email on
--no-dns no DNS server (BIND): your domains' DNS stays at another provider DNS on
--no-portals one panel for everyone at https://panel.yourdomain.com:8443, instead of separate Server Admin, Control Panel and Reseller Panel separate panels

What gets installed depends on your plan

Your licence's plan decides which parts are installed: without Email the installer works as with --no-mail, without DNS as with --no-dns, and without Reseller Panel, HF Files, HF Studio or API it leaves out that part's own address (reseller., files., db., api.). Without HF Studio there are no PostgreSQL and MongoDB databases, and without Apps no Node.js, Ruby, Perl modules, PEAR or Composer. The full list is in Install.

The options above can only take more away. A part you leave out with an option (--no-mail, --no-dns, --no-portals) stays out when your plan changes later; hf-panel licence sync never adds it back.

Note: the company name is asked only when the domain or email is asked too. In an install without questions it is --company, or the suggestion.

Install without any questions

Give the licence key, the host name and the email, and the installer runs without asking anything:

bash
cd /home && curl -o latest -L https://get.hostfog.io/latest && \
  bash latest --licence HFL-XXXXX-XXXXX-XXXXX-XXXXX --hostname panel.yourdomain.com \
  --email you@yourdomain.com --company "Your Hosting Ltd"

Without a keyboard (for example from a provisioning script), the installer also skips the Enter at the summary and the admin login. Create the first administrator afterwards:

bash
hf-panel create-admin

Important: without a keyboard, the installer cannot ask for a licence key or start a trial. Pass --licence.

Examples

A web-only server, with email and DNS handled elsewhere:

bash
bash latest --no-mail --no-dns

A different panel port and Node.js 22:

bash
bash latest --port 2083 --node 22

Your own mail server and nameserver names:

bash
bash latest --mail-host mx1.yourdomain.com --ns1 dns1.yourdomain.com --ns2 dns2.yourdomain.com

Note: when you change the port with --port, open that port instead of 8443 in your provider's firewall, and use it in the panel addresses, for example https://server.yourdomain.com:2083.

Change things after installing

What How
Follow a plan change now (set up what it gained, switch off what it lost) hf-panel licence sync (runs once a day by itself)
Separate panels on or off, or other names for them hf-panel portals on / hf-panel portals off (--admin, --customer and --reseller choose the names)
HF Files, HF Studio, the API or the status page on their own address hf-panel files-portal on|off, hf-panel db-portal on|off, hf-panel api-portal on|off, hf-panel status-page on|off
The mail server's name hf-panel mail-name mail2.yourdomain.com
Newer Nginx, Apache, MariaDB, PostgreSQL, Redis, Node.js Server Admin › System › Software versions
PHP versions Server Admin › System › PHP & Node.js
The company name, logo and colours Server Admin › System › White label
Every other server command Server commands