# FAQ

## Installation

**Q: Which operating systems are supported?**  
A: Ubuntu 24.04 LTS (x86_64) is the only supported OS at this time. Additional distributions are planned post-v1.

---

**Q: Can I install NixPanel on a server that already has software on it?**  
A: It's not recommended. NixPanel installs and configures Apache, MariaDB, PowerDNS, Exim, and Dovecot. Running it alongside existing web server software will likely cause port conflicts. Use a fresh server.

---

**Q: The installer failed partway through. What do I do?**  
A: Just re-run it. The installer tracks completed steps in `/var/lib/nixpanel/install/` and skips anything already done:

```bash
sudo bash install.sh
```

To force a specific step to re-run, delete its `.done` file:

```bash
rm /var/lib/nixpanel/install/<step_name>.done
```

---

**Q: Do I need a license key to install?**  
A: Yes, a license key is required during install — even for the Free plan. Create a free account at [nixpanel.io](https://nixpanel.io) to get one.

---

**Q: PHP 8.2 packages weren't found during install.**  
A: This can happen on Ubuntu 24.04 if the `ondrej/php` PPA wasn't added. The latest installer handles this automatically. Make sure you're running the current version:

```bash
bash <(curl -fsSL https://raw.githubusercontent.com/NixReaper/nixpanel/main/install.sh)
```

---

## Licensing

**Q: What happens if my server can't reach license.nixpanel.io?**  
A: A 7-day grace period applies. Your panel keeps working normally. If connectivity isn't restored within 7 days, non-free features are restricted until the license is validated again.

---

**Q: Can I run NixPanel on multiple servers?**  
A: The Host plan supports 1 server; Agency supports unlimited servers. Each server needs its own IP registered to your license. Free and Solo plans are single-server only.

---

**Q: I moved to a new server. How do I update my IP?**  
A: Log in to [nixpanel.io/dashboard](https://nixpanel.io/dashboard) → License → Change Server IP.

---

## Panel

**Q: What ports does NixPanel use?**  
A: The admin panel (NixServer) runs on port `2087`. The user panel (NixClient) runs on port `2083`. DNS is on port `53`, SMTP on `25`, IMAP on `143`/`993`, POP3 on `110`/`995`.

---

**Q: How do I add SSL to my panels?**  
A: Run `certbot --apache` after pointing a domain at your server. Certbot will automatically configure HTTPS for both panels.

---

**Q: Can NixPanel host WordPress sites?**  
A: Yes. NixPanel uses MariaDB (fully MySQL-compatible) and installs PHP-FPM 8.2 and 8.3. WordPress one-click install is available on Solo, Host, and Agency plans.

---

**Q: How do I restart the panel after making config changes?**  
A:
```bash
systemctl restart nixpanel
```

---

**Q: Where are the logs?**  
A:
```bash
journalctl -u nixpanel -f               # live panel logs
tail -f /var/log/nixpanel/panel.log     # panel log file
tail -f /var/log/nixpanel/panel-error.log
```

---

## Billing

**Q: What payment methods do you accept?**  
A: All major credit and debit cards via Stripe. No PayPal at this time.

**Q: Can I cancel anytime?**  
A: Yes. Cancel from your dashboard. Your panel keeps working until the end of the billing period — no partial refunds.

**Q: Do you offer refunds?**  
A: We offer a full refund within 7 days of your first payment if NixPanel doesn't work for your use case. Contact support@nixpanel.io.

---

## Getting Help

Still stuck? Email **support@nixpanel.io** or open an issue at [github.com/NixReaper/nixpanel/issues](https://github.com/NixReaper/nixpanel/issues).