OLSPanel Installation Guide for Latest version (2.0.1)

Step-by-step instructions to install OLSPanel on all supported platforms.

Minimum Requirements

Before installing OLSPanel, ensure your server meets the following minimum requirements to guarantee optimal performance and compatibility.

Operating System

  • Ubuntu 20 or 22 or 24
  • Debian 11 or 12
  • Almalinux 8 or 9
  • CentOS Stream 8 or 9

Note: OLSPanel does not support Windows servers. For Windows-based hosting, consider using a virtual machine with a supported Linux distribution.

Installation Command

Regardless of the platform, the following steps are common for all installations:

apt update && apt -y upgrade && apt -y install curl wget sudo
bash <(curl -fsSL https://raw.githubusercontent.com/osmanfc/olspanel/main/install.sh || wget -qO- https://raw.githubusercontent.com/osmanfc/olspanel/main/install.sh)

Note: After installation,you get login information username , password and url for access OLSPanel like as
https://your-server-ip:port
username: admin
password: **********

Ignore the self-signed certificate warning and create an admin user immediately to prevent unauthorized access.

Overview

Server Setup Illustration

OLSPanel can be installed on various cloud platforms or a dedicated server. This guide covers installation on Amazon Web Services (AWS), DigitalOcean, Google Cloud, Microsoft Azure, Vultr, and other dedicated servers. Before proceeding, ensure your server meets the system requirements.

Installation on Cloud Providers

Amazon Web Services (AWS)

  • Log in to the AWS Management Console and go to EC2 Service.
  • Launch an instance with Ubuntu 24.04, 22.04, or Debian 12, 11 (x86 or ARM).
  • Select an instance type meeting the minimum requirements (1 CPU, 2 GB RAM).
  • Create or select a key pair for SSH access.
  • Configure network settings: select VPC, subnet, and create a security group allowing all TCP traffic (OLSPanel manages its own firewall).
  • Associate an Elastic IP to your instance.
  • SSH into the instance: ssh -i your_private_key.pem ubuntu@yourElasticIpAddress
  • Run the installer with your preferred database engine:
bash <(curl -fsSL https://raw.githubusercontent.com/osmanfc/olspanel/main/install.sh || wget -qO- https://raw.githubusercontent.com/osmanfc/olspanel/main/install.sh)

DigitalOcean

  • Create a Droplet in your DigitalOcean account.
  • Choose Ubuntu 24.04, 22.04, or Debian 12, 11 as the OS image.
  • Select a Droplet size (e.g., Premium AMD with NVMe SSD).
  • Choose SSH key or password authentication.
  • Assign a Reserved IP for a static IP address.
  • SSH into the Droplet: ssh root@yourDropletIpAddress
  • Run the installer:
bash <(curl -fsSL https://raw.githubusercontent.com/osmanfc/olspanel/main/install.sh || wget -qO- https://raw.githubusercontent.com/osmanfc/olspanel/main/install.sh)

Google Cloud

  • Create a VM instance in Google Cloud Console.
  • Select Ubuntu 24.04, 22.04, or Debian 12, 11 as the boot disk image.
  • Choose a machine type meeting the minimum requirements.
  • Add a network tag (e.g., OLSPanel) for firewall rules.
  • Create a static IP address in the network interface settings.
  • Create a firewall rule to allow TCP port 8443 (OLSPanel).
  • SSH into the instance and run the installer:
bash <(curl -fsSL https://raw.githubusercontent.com/osmanfc/olspanel/main/install.sh || wget -qO- https://raw.githubusercontent.com/osmanfc/olspanel/main/install.sh)

Microsoft Azure

  • Log in to the Azure Portal and create a Virtual Machine.
  • Select Ubuntu 24.04, 22.04, or Debian 12, 11 as the image.
  • Choose a size meeting the minimum requirements.
  • Use SSH public key authentication and enter your username and key.
  • Create a firewall rule to allow all TCP traffic (or specific ports: 22, 80, 443, 8443, and 443 UDP for HTTP/3).
  • SSH into the instance: ssh -i your_private_key azure@yourIpAddress
  • Run the installer:
bash <(curl -fsSL https://raw.githubusercontent.com/osmanfc/olspanel/main/install.sh || wget -qO- https://raw.githubusercontent.com/osmanfc/olspanel/main/install.sh)

Vultr

  • Create an instance in Vultr
  • Choose a server size and location.
  • Configure SSH key authentication.
  • SSH into the instance and update the system.
  • Run the installer:
bash <(curl -fsSL https://raw.githubusercontent.com/osmanfc/olspanel/main/install.sh || wget -qO- https://raw.githubusercontent.com/osmanfc/olspanel/main/install.sh)

Installation on a Dedicated Server (Other)

For a dedicated server or any other cloud provider not listed above, follow these steps:

  • Use a fresh server
  • Log in via SSH as root: ssh -i your_private_key root@yourIpAddress or ssh root@yourIpAddress (if using a password).
  • Update the system as shown in the prerequisites.
  • Run the installer with your preferred database engine:
bash <(curl -fsSL https://raw.githubusercontent.com/osmanfc/olspanel/main/install.sh || wget -qO- https://raw.githubusercontent.com/osmanfc/olspanel/main/install.sh)

Post-Installation Steps

After installation on any platform:

  • Note: After installation,you get login information username , password and url for access OLSPanel like as
    https://your-server-ip:port
    username: admin
    password: **********

    Ignore the self-signed certificate warning and create an admin user immediately to prevent unauthorized access.

  • Create an admin user and enable Two-Factor Authentication (2FA) for security.
  • Configure your domain and issue a free Let's Encrypt SSL certificate through the OLSPanel interface.
  • Explore the admin area to add sites, manage databases, and configure services.
Next: Contact Us