FAQ
Questions and answers
The questions someone would ask before installing or running the panel, grouped by topic. The answers rest on the panel's README and docs.
Topics
Licence and cost
Does Lightning VM cost anything? #
No. Lightning VM is open source and distributed under the Apache-2.0 licence. All of the source code is in the public repository on GitHub. There is no licence fee, no fee per server or per customer, and no paid edition. All the customer and admin features, the seven platform adapters, installation and updates are in that one repository.
May I use it commercially and change it? #
Yes. The Apache-2.0 licence lets you install it on your own server, change the code and use it commercially. The full text of the licence is in the LICENSE file of the repository; third-party content in the repository (icons, fonts) is listed in the NOTICE file.
What does the Apache-2.0 licence allow, and what does it ask of me? #
You may use the software, change it, distribute copies and sell services with it. In a copy you distribute you have to keep the licence text and the copyright and attribution notices, and state which files you changed. The software is provided as is, without warranty. This is a summary; what governs is the LICENSE text in the repository.
Can I contribute? #
Yes. Open an issue to report a bug, or send a pull request to the repository with a fix. The rules for contributions are in the CONTRIBUTING.md file of the repository.
Is there paid support or an installation service? #
No. This site sells no paid support, SLA or service. For questions and bug reports you can open an issue on GitHub.
So what will it cost me? #
The server the panel runs on (at least 2 GB RAM and 10 GB disk), your own virtualisation infrastructure, and whatever the outside services you use charge (a payment provider, an SMS provider, an e-invoice integrator and the like). The panel takes no share of any of these.
Installation
What do I need to install it? #
A separate Linux server running Ubuntu 22.04, 24.04 or 26.04 (amd64 or arm64), at least 2 GB RAM and 10 GB free disk, and ports 80 and 443 open to the outside. Recommended are 4 GB RAM and a domain whose A record points at the server. If Docker is not installed, the script installs it from its official repository.
How do I install it? #
On a fresh server you run the command below. It fetches the source into /opt/lightning-vm, selects the latest stable release and starts the installation. All the steps are described in the article What the one-line install does.
curl -fsSL https://lightningvm.app/install.sh | sudo shCan I install the panel on the virtualisation host itself? #
The docs advise against it: install the panel on a separate Linux server, not on the host. That server may be a virtual machine.
What if I have no domain? #
If the server has a public IPv4 address, the panel opens under <ip>.sslip.io and obtains a Let's Encrypt certificate. If there is no public IP either, you install with --local; the panel is then reachable on the server itself only, and you connect through an SSH tunnel. You can add a domain later under Settings → Domain and SSL or with the install.sh domain command.
Does it run behind an existing Nginx, Caddy or Traefik? #
Yes, with the command below. You have to give the panel's public address, because links sent by e-mail use it. The proxy configuration is in docs/domain-https.md (Turkish).
sudo sh scripts/install.sh behind-proxy --public-url https://panel.example.comThe installation stopped halfway. What now? #
Run the same command again. Existing secrets, data and accounts are kept; the script only completes what is missing.
Where do I find the first admin's password? #
It is shown once at the end of the installation and written to secrets/initial-admin.txt. Change the password after your first sign-in and delete the file. If you forget the password, the command below generates a new one.
sudo sh scripts/install.sh reset-password you@example.comWhat should I do first after installing? #
Sign in, change your password and switch two-factor authentication on. Add your platform under Administration → Connections. Under Administration → Catalog prepare a location, a resource pool, an IP pool, a template image and packages. Set up e-mail, SMS and payments. Then order a server with a customer account and try the flow end to end.
Platforms
Which virtualisation platforms does it support? #
VMware vSphere (vCenter / ESXi 6.0 to 9.x), Proxmox VE 7.x to 9.x, XCP-ng 8.x, oVirt 4.4+, Hyper-V (Windows Server 2016+), a KVM host with libvirt, and Incus 6.x / LXD 5.x. Only VMware has every feature; what the others have is in the coverage table.
Have all these platforms been tried on real hardware? #
No. The VMware side was tested mostly with the simulator. Incus was tried on a real Incus 6.0 server, with containers only. The Proxmox VE, XCP-ng, oVirt, Hyper-V and KVM adapters have never run on a real hypervisor; their tests run against mock servers that imitate the platform. Try your platform in your own test environment before production.
Can I sell servers with a standalone ESXi host or with free ESXi? #
No. On VMware, creating servers needs vCenter. A standalone ESXi host offers only read and power operations, and with the free ESXi licence the API is read-only.
Which platforms have the browser console? #
VMware only. In addition, the VMware HTML Console SDK is not in the repository, because its licence does not allow it; whoever installs the panel adds it. The gateway and the ticket flow were tested, but nobody has verified with the real SDK that the screen appears and the keyboard works.
Why does the firewall work on VMware only? #
The rules are enforced by the port filter of VMware's distributed virtual switch. That is why vCenter and a vSphere Distributed Switch are needed; the other adapters do not have this operation.
Can I bring my existing virtual machines into the panel? #
Yes. You can adopt a VM created outside the panel as a customer's server while it keeps running. Adoption exists on all seven platforms.
Can I sell Windows servers? #
The README mentions Windows only where it sets limits: the Hyper-V and KVM adapters have no Windows guest customisation, and the operating-system updates feature for customer servers does not work on Windows. How Windows templates behave on VMware is not described in the README; you would have to try it with your own template.
Is IPv6 supported? #
Partly. There is no separate IPv6 pool; you add an optional prefix to an IPv4 pool, and every server gets a single address from that prefix.
Billing and payments
Which payment providers can I collect payments with? #
Card payments are collected only through iyzico, PayTR, Craftgate, Param and Stripe. For the other 41 providers in the settings only the account details are stored; no payment can be taken through them. None of the five was tried with a real merchant account; make one payment and one refund in test mode before going live.
Why are Param payments not confirmed automatically? #
A return from Param cannot be verified by asking Param, so it does not count as proof of payment. The payment stays "awaiting confirmation"; staff see the collection in the Param panel and close the invoice by hand with "Record a payment". Param is offered for TRY invoices only.
What happens if a customer pays on Stripe and closes the tab? #
There is no webhook for Stripe. The payment is not processed at once; five minutes after the payment was started, the collection run begins asking Stripe again and processes the result. The same asking-again exists for iyzico and Craftgate.
What happens to a server when its invoice is not paid? #
First a reminder goes out, and the day after the due date an overdue notice. After the number of days you have configured the server is suspended: it is shut down and locked for the customer. If you have configured it, it is deleted later. Paying lifts the suspension and the server is powered on again.
What is a "payment awaiting review"? #
A payment that does not settle by itself: Param payments awaiting confirmation, payments whose amount does not match, and payments the provider has put under review. The decision is made by hand. While the review is open, for at most reviewHoldDays days (7 by default), suspension, deletion and reminders wait for that invoice. The details are in this article.
Is there hourly billing? #
Yes. If hourly sales and the balance are switched on in the billing settings and you gave the package an hourly price, the customer orders the server by the hour. The charge is deducted from the balance; when the balance runs out the server is put on hold. A usage invoice is issued at the end of the month.
Can I send Turkish e-invoices (e-Fatura and e-Arşiv)? #
Seven integrators are defined: İzibiz, Uyumsoft, Nilvera, EDM, QNB eFinans, BirFatura and Paraşüt. A real e-Arşiv invoice was sent only to İzibiz and Uyumsoft, in their own test environments. The other five were written from their documentation and not tried; sending an e-Fatura (to a registered buyer) was not tried with any real integrator.
I sell through WHMCS or WISECP. Can I use the panel? #
Yes, with the modules in the repository. That system does the selling, and the panel issues no invoices for those servers. Their owner cannot enlarge them, add disks or clone them from the panel; a package change is made in that system. The WISECP module was not tried on a WISECP installation.
Who pays the invoice when servers are sold through a reseller? #
Whoever can manage the server. The reseller orders on the customer's behalf and the subscription is invoiced to the reseller. When the customer leaves the reseller, the subscriptions and the payment pass to the customer. The details are on the Resellers page.
Security
What does beta mean here, and which version is this? #
Lightning VM is in beta; it has not reached a full release (1.0). It is under active development and has not been validated on real hardware for every platform: the VMware side was tested mostly with the simulator, Incus was tried on a real server with containers only, and the Proxmox VE, XCP-ng, oVirt, Hyper-V and KVM adapters have never run on a real hypervisor. None of the five payment providers was tried with a real merchant account. Behaviour can change between versions; read upgrade-notes.md in the repository before upgrading.
Is it ready for production? #
The README's own answer is cautious. The project is a development release and was written largely with AI (Claude Code). Every change went through unit, integration and end-to-end tests, but there may be bugs and security holes, and it has not had an independent security audit. Before you use it with real customers and real money, try it in your own environment, take backups and review the code.
Has there been a security audit? #
In November 2026 a partial, AI-assisted audit was carried out in two rounds; 48 weaknesses in total were confirmed and fixed. It is not an audit by an independent third party. What was looked at and what was not is described in a separate article.
Are there two-factor authentication and passkeys? #
Yes. An authenticator app (TOTP), a code by SMS or e-mail, and backup codes are supported; signing in with a passkey takes the place of two-factor authentication. You can make two-factor authentication mandatory for a role.
Can people sign in with LDAP, Active Directory or SSO? #
Yes: LDAP / Active Directory and OpenID Connect (Keycloak, Entra ID, Okta, Google, authentik). Groups are mapped to roles. These paths were not verified with a real directory server or SSO provider; try them from start to finish with your own.
My customer used "Forgot my password" and the saved card was removed. Why? #
The e-mail address of an account opened by registration is not verified. When the account proves its address for the first time (a password reset counts as proof), the API tokens, SSH keys, passkeys and saved cards set up on the account before are erased once, because the account may not have been opened by the owner of the address. Servers, the balance and tickets stay. The card has to be saved again for automatic renewal.
Where do I report a security vulnerability? #
Do not open a public issue. Follow the route in SECURITY.md in the repository: on GitHub, Security → Report a vulnerability.
Updates and backups
How do I update the panel? #
Under Administration → System → Updates, or with the command below. Every update takes a backup first; if the new version does not become ready, the containers go back to the previous version. The database is not rolled back automatically. Read upgrade-notes.md in the repository before upgrading.
sudo sh scripts/install.sh updateIs there automatic updating? #
Yes, if you want it. You choose the channel (stable, beta, edge) and a maintenance window.
sh scripts/install.sh auto-update on --channel stable --window 03:00-05:00Where are backups kept, and what do they contain? #
In a default installation, only in the backups/ folder of the panel's server; the 7 newest are kept. A backup contains the database, the settings, the master key and the certificates. For a copy off the server, set BACKUP_COPY_TO in .env. A backup does not contain customer VMs.
What happens if I lose «backup.key»? #
No backup can be opened. The key is not inside the backup and cannot be regenerated. Right after installing, copy it to a place off the server and apart from the backups.
Why does the panel do nothing after a restore? #
A restore puts the panel on hold: the database that came back is older than reality, and if the panel acted on old records it could harm running servers. Once you have looked at what changed since the backup, you lift the hold from the banner under Administration → System.
Can I go back to an older version? #
Yes, by naming the version explicitly. Only the migration check stops it: if a migration applied to the database does not exist in that version, the script refuses.
sudo sh scripts/install.sh update --to v1.2.0Troubleshooting
A server stays in the state "operating system not ready". #
On VMware, three things must be true together for a server to count as ready: it is powered on, VMware Tools is running in the guest, and the guest reports the IP address assigned through cloud-init. Check that VMware Tools and cloud-init are installed in your template and recent enough (for vCenter 7.0 U3+, Tools 11.3+ and cloud-init 21.3+).
I get the error «ENDPOINT_BLOCKED» when adding a connection. #
The adapters refuse loopback and link-local addresses and addresses on the panel's own Docker networks. If your platform is on such a network, add it to that adapter's allow list in .env; for Proxmox, for example, the line below.
PROXMOX_ALLOW_NETWORKS=10.20.0.0/16An operation says "not supported on this platform". #
That adapter does not implement that operation. Which operation exists on which platform is in the coverage table.
On Proxmox the root password and the hostname are not applied. #
Proxmox's own cloud-init carries only the network and the SSH keys. The root password, the hostname and app installation are applied through the QEMU guest agent; they are not applied if the template has no agent or the API token lacks the guest-agent privilege.
On oVirt the server gets no address. #
The first network interface in the guest must be called eth0; the Engine writes the network settings under that name. If it is not, add net.ifnames=0 to the kernel command line.
Telegram or WhatsApp notifications do not arrive. #
On Telegram the bot must not have a webhook defined. WhatsApp needs the Meta Cloud API and an approved message template. You can try every channel with "Send a test" under My account → Notifications (6 tests an hour per account).
I cannot switch monitoring (Grafana, Prometheus) on from the panel. #
After installation, monitoring is switched on and off from the command line only, with the command below. The panel has a switch for it only in the setup wizard.
sudo sh scripts/install.sh monitoring onI found a bug, or something does not work the way the docs say. #
Open an issue on GitHub. The project was tested largely away from real hardware, which is why bug reports from your environment are valuable.
If your question is not answered here, see the feature pages or the articles.
Install command
curl -fsSL https://lightningvm.app/install.sh | sudo shUbuntu 22.04 / 24.04 / 26.04. Requirements and options
