Skip to content

Quick Start

This guide takes a fresh VPS to a working AidiPanel installation and an isolated first site.

1. Prepare the server

Use a fresh Ubuntu 22.04/24.04/26.04 or Debian 11/12 VPS with root or sudo access. Update it before installing AidiPanel:

bash
sudo apt update
sudo apt upgrade -y

If the upgrade requests a reboot, complete it before continuing:

bash
if [ -f /var/run/reboot-required ]; then sudo reboot; fi

Reconnect over SSH after the server comes back online.

2. Install AidiPanel

bash
curl -fsSL https://get.aidipanel.com | sudo bash

The URL redirects to the installer from the latest stable GitHub release. Save the generated panel password printed at the end. It is also stored in /opt/aidipanel/credentials.conf, readable only by root.

For checksum verification and installer options, see Installation.

3. Sign in

Open https://<server-ip>:8443 and sign in as admin with the generated password.

Initial certificate warning

The panel initially uses a self-signed certificate. Verify that you are connecting to the intended server before accepting the browser warning. You can assign a domain and trusted certificate from panel settings later.

4. Point DNS to the server

Create an A record for your domain using the server's public IPv4 address. Add an AAAA record only when IPv6 is configured correctly.

bash
dig +short example.com

Wait until the result matches your server before requesting a trusted certificate.

5. Create a site

For a generic PHP site:

bash
sudo aidipanel site:add --domain example.com --user example --type php

This creates /home/example/htdocs/example.com, a dedicated no-login Linux user, an isolated PHP-FPM pool, and an Nginx vhost. You can also create the site from Sites → Add Site in the panel.

WordPress

WordPress provisioning requires the site title and administrator details. Pass the password over stdin so it is not retained in shell history:

bash
printf '%s\n' 'StrongPassword123!' |
sudo aidipanel site:add \
  --domain blog.example.com \
  --user blog \
  --type wordpress \
  --wp-title 'Example Blog' \
  --wp-admin-user admin \
  --wp-admin-pass-stdin \
  --wp-admin-email admin@example.com

The command installs WordPress, creates its database and database user, writes wp-config.php, and creates the administrator account as one workflow. The panel form provides the same required fields.

6. Install SSL

After DNS resolves to the server:

bash
sudo aidipanel ssl:install --domain example.com --email admin@example.com

New sites allow HTTP initially and use a temporary self-signed certificate for HTTPS. After a trusted certificate is active, enable force HTTPS and HSTS from the site's SSL tab when appropriate.

7. Enable caching when appropriate

Page cache is off by default:

bash
sudo aidipanel cache:enable --domain example.com

For WordPress, enable the Nginx cache helper from the panel or use the documented CLI option so publishing content can purge stale pages. Review FastCGI Cache before enabling it on dynamic applications.

Next steps

Site Management → Learn site types, file paths, PHP selection, security, backups, and deletion behavior.

CLI Reference → Browse all supported command groups and safe examples.

Troubleshooting → Start with symptoms when an installation, domain, certificate, or site is not working.