Get WardPane
Install the same release with one command or from an archive sent by email. Both ask for your email and two confirmations: the address is for security notices, and the law requires the consent records.
One command
On a clean Ubuntu 24.04 server, as root or with sudo:
$ curl -fsSL https://wardpane.com/install | sudo bash
Available after the release.
You can read the script before you run it: curl -fsSL https://wardpane.com/install | less
- Checks that this is Ubuntu 24.04 and that curl and tar are present.
- Asks for your email and shows links to the Terms of use, the Privacy policy and the Consent.
- Asks whether you accept the Terms and the Privacy policy, then whether you consent to the processing of personal data. No stops the install.
- Asks whether to send you news about releases and security fixes. The default answer is No.
- Sends a six-digit code to your email. It is valid for 15 minutes and 5 attempts.
- Downloads the archive over HTTPS, checks its SHA-256, extracts it and runs install.sh.
Installer options
Add options after bash -s -- at the end of the command. This example also installs PHP:
curl -fsSL https://wardpane.com/install | sudo bash -s -- --php
| Option | What it does |
|---|---|
--email EMAIL | Email for the Let's Encrypt account. Without it the installer asks. |
--php | Install PHP (php-fpm) so sites can run PHP, each in its own sandbox. |
--no-php | Do not install PHP and do not ask. |
--user NAME | Panel user name. Without it the installer offers a random one. |
--password PASS | Panel password. Typing it at the prompt is safer, because other users can see options in ps. |
--ip ADDRESS | Public IPv4 address of the server, if detection picks the wrong one. |
--root-login | Allow signing in to the panel as root with the server's root password. |
--no-root-login | Do not allow root sign-in and do not ask. |
--staging | Use the Let's Encrypt staging environment, for tests. |
--no-ufw | Leave the firewall as it is. |
--force | Skip the operating system version check. |
-y, --yes | Never ask questions: default answers and a random password. |
Archive by email
The first release is on its way
WardPane 2.0 is being prepared. There is nothing to download yet, so this page does not ask for your email. Check back soon.
We email you a download link. It works for 24 hours and for one download.
Check your inbox
- The link works for 24 hours and for one download.
- If the download breaks, open the same link again from the same network to resume.
- Nothing came? Check spam, the email comes from [email protected].
- If you asked for news, confirm the subscription with the second email.
What the installer changes
- Installs Node.js for the panel, and PHP (php-fpm) if you ask for it.
- Creates the system user wardpane for the panel and the Linux user www-root that owns new sites.
- Installs the service wardpane, puts the panel in /opt/wardpane and its data in /var/lib/wardpane; sites live in /var/www.
- Configures ufw to allow SSH, 80, 443 and 1500. Use --no-ufw to leave the firewall alone.
- Asks for the panel sign-in and for the email of the Let's Encrypt account.
- Keeps a backup in /var/backups/wardpane before every update. Logs: journalctl -u wardpane.
- Removes everything with sudo /opt/wardpane/uninstall.sh; site files in /var/www stay.
System requirements
- System
- A clean Ubuntu 24.04 LTS, x86_64 or arm64
- Memory
- 1 GB of RAM for a dozen small sites; 512 MB works with the GeoLite2 Country database
- Ports
- 80 and 443 free for the sites, 1500 for the panel
- Access
- root or sudo, and outbound HTTPS for Let's Encrypt and updates
- Optional
- a domain, a Cloudflare API token, a free MaxMind key for GeoIP updates
Checksum
Current release
The first release is not published yet. Its version and checksum will appear here.
- Version
- 2.0.0
- File
wardpane-2.0.0.tar.gz- Size
- SHA256
Each release archive has a .sha256 file next to it with its SHA-256 checksum, and the same value is shown above. The one-command installer checks it automatically. To check an archive you got by email, download the .sha256 file into the same folder and run:
Compare the checksum with the .sha256 file:
sha256sum -c wardpane-2.0.0.tar.gz.sha256
If the checksum does not match, do not run the archive and write to [email protected].
Source code
WardPane is free software under the GNU Affero General Public License, version 3. There is no public repository at the moment: every release archive contains the full source code of that version, including install.sh, and the install script itself is plain text you can read before running it.
Read the AGPL-3.0 licenseWhat is new
Read the changelogUpgrading from Small Web Panel 1.x
WardPane 2.0 is Small Web Panel under a new name. The new installer takes over a 1.x install in place, backs everything up first and rolls back on its own if the new version does not start.