Installation Guide

Up and running in minutes.

OkPanel installs with a single command on a fresh Ubuntu server. The script sets up Nginx, PHP, MariaDB, phpMyAdmin, SSL, and the panel itself — no manual configuration.

Before you start

Ubuntu 22.04 or 24.04

A 64-bit (amd64 or arm64) server. Other distros aren't supported yet.

A fresh, clean server

No existing Nginx, Apache, or MySQL/MariaDB — the installer stops if it finds them.

Root access

Run as root or with sudo. Low-RAM VPS work — swap is added automatically if needed.

Open port 2222

Allow 2222 (panel) plus 80/443 in your provider's firewall.

Install in three steps

1

Log in and install curl

SSH into your fresh server as root and make sure curl is available.

apt update && apt install -y curl
2

Run the installer

One command downloads and runs the installer. It will ask you to confirm before making changes, then set everything up automatically.

$ curl -sSL https://cdn.okpanel.org/install.sh | sudo bash

Installs Nginx, PHP 8.3 & PHP-FPM, MariaDB, phpMyAdmin, SSL, and the OkPanel services. Typically finishes in a few minutes.

3

Save your credentials and log in

When it finishes, the installer prints your login details. Copy them somewhere safe — the password is generated once.

# OkPanel Login Details

Login URL: https://YOUR_SERVER_IP:2222

Username: admin

Password: [auto-generated]

The panel uses a self-signed certificate on first boot, so your browser will show a security warning — that's expected. You can issue a trusted Let's Encrypt certificate for the panel hostname later.

What's next

Add your first site. From Create Website, add a domain and OkPanel provisions the vhost, system user, and document root for you.

Point your DNS. Aim your domain's A record at your server IP, then issue a free Let's Encrypt SSL certificate in one click.

Explore the tools. Databases, email, Node.js apps, backups, and the security center are all a click away from each site's Manage page.

Upgrading

No terminal needed — upgrade straight from the panel. Open Upgrade Panel in the sidebar to see your current version against the latest release, and update with a single click. Your sites and settings are preserved.

Admin → Upgrade Panel

When an update is available the panel flags it for you. Click upgrade and watch the live session logs — OkPanel downloads the new release, swaps the binaries, and restarts its services automatically. Keep the tab open until it reconnects.

Stuck, or want it done for you?

We're offering free installation for a limited time. Email us and we'll set OkPanel up on your server, usually within 24 hours on working days.