Help Center
Need a hand?
Just ask us.
Browse the knowledge base below. If you don't find what you need, chat or email us. NZ-based engineers reply fast.
229 results
Get help now
Three ways to reach us
All routes go to NZ-based engineers. No offshore tier-1 desks, no chatbot dance, no scripts.
support@kapsulehost.com
Replied within 4 business hours. Faster for urgent.
Best for: anything not urgent. Lets you include screenshots and detail.
Live chat
In the panel after signup
Instant response during business hours.
Best for: quick questions, account changes, "is this on fire?" panic.
Phone
Available to Managed customers
Business hours. Direct line to your account manager.
Best for: Managed plan customers needing direct engineer time.
Knowledge base
Help articles
Popular articles
Getting Started with KapsuleHost
Welcome to KapsuleHost. This guide walks you through everything you need to do after signing up, from your first login to having a live website and working email address. The whole process takes…
SSL Certificates and HTTPS
This article explains what SSL is in plain language, how Kapsule handles SSL automatically for your sites, and what to do if something goes wrong with your certificate.
Installing WordPress
WordPress is the most widely used website platform in the world, and KapsuleHost makes installation automatic. This guide covers two installation paths, how to manage your credentials, accessing the…
Setting Up Your Email Mailbox
This guide walks through creating a mailbox at your domain, from prerequisites to sending your first test email. It also covers how MX records work, what to do if your domain uses external…
Connecting via SFTP: FileZilla, Cyberduck, and Command Line
SFTP (Secure File Transfer Protocol) gives you direct access to your site's files on the server. This guide covers everything you need to connect successfully, from finding your credentials to…
My Website Is Not Loading: Diagnostic Checklist
Work through these steps in order. Each step either identifies the cause or rules it out. Most issues are resolved by step 5.
Browse by topic
Orbit40
Our Build Machine Could Not Run This
If your deployment says Our build machine could not run this, the machine we started for your build reported that something was wrong with itself, before or instead of anything going wrong with your…
A Transfer at Our End Failed
If your deployment says A transfer at our end failed, we could not move a file your build needed, and the file was one we are responsible for moving. That is a fault at our end. Nothing in your…
Our Build Sandbox Got No Address
If your deployment says Our build sandbox got no address, we could not give the machine that runs your build a network address, so the build never started. That is a fault in our build…
Our Build Sandbox Failed
If your deployment failed with Our build sandbox failed, the isolated machine that runs your build stopped responding before it could report a result. That is a fault in our build infrastructure…
Blocked by Our Policy: When a Build's Outbound Connection Is Refused
If your deployment failed with Blocked by our policy, our build network refused a connection your build tried to make. That refusal was our policy acting, not a fault in your code. This guide…
Connecting an Azure DevOps Repo
Orbit deploys from Azure Repos, the git hosting inside Azure DevOps. Connect once, pick a repository, and every push builds and goes live. This guide covers both ways to connect, selecting a…
Snapshots and Restore in Orbit
Every Orbit project takes a nightly snapshot of two things that are otherwise impossible to get back once you delete them: your config store entries and your environment variables. Thirty nights are…
Orbit Webhooks
Webhooks push a signed HTTP POST to a URL of your choosing every time a deployment changes state, so your team hears about a failed build in the channel they already watch instead of finding out…
Orbit Web Vitals
The Web Vitals tab reports Core Web Vitals collected from your project's real visitors rather than from a synthetic test, so what you see is what people are actually experiencing on their own…
Orbit Status Page
A status page is a public, no-login URL that shows whether your project is up, how it has performed recently, and what you have deployed. Turning it on also starts an uptime check that pings your…
Orbit Project Settings
Every knob for an Orbit project lives on the Settings tab, grouped so you can find things: general information, build and deploy, security, notifications, integrations, usage limits, deploy…
Orbit Releases
The Releases tab turns your git tags into a version history you can read: every tagged deployment, in order, with its commit, its author, its status and a link straight to the tag in your repository.
Viewing Your Project README In Orbit
The Docs tab renders your repository's README inside KPanel, so the project's own documentation is one click from its deployments instead of in a browser tab someone has to go and find.
Transferring an Orbit Project
A project can be moved to a different Kapsule account without redeploying it or rebuilding its configuration. The move is email-verified, reversible only by transferring it back, and takes…
Orbit Deployment Pipeline
The Pipeline tab is a single page that answers "what happens when we push". It shows every way a deploy can be triggered, every gate that can stop one, the state of each environment, and which build…
Orbit Build Insights and Delivery Insights
Orbit has two insight views: a per-project Build Insights tab that answers "why are our builds slow", and an account-wide Insights page that answers "how well are we shipping". This guide covers…
Shared Environment Variable Groups
An environment variable group holds values that several Orbit projects need, such as a shared API key or a database credential, in one place. Link the group to the projects that need it and every…
Orbit Cron Jobs
Cron jobs schedule recurring HTTP requests to your deployed project, so a nightly cleanup, an hourly sync or a weekly digest runs on time without you standing up a separate scheduler.
Orbit API Tokens and the REST API
API tokens let a script, a CI pipeline or your own tooling drive Orbit without a browser session: trigger deployments, report CI check results, download build artifacts, manage cron jobs and more…
Orbit Timeline Annotations
Annotations let you write context onto a project's timeline: the incident that started at 2am, the release that changed the checkout flow, the feature flag someone flipped. Six months later they are…
Orbit Project Analytics
The Analytics tab is the full picture of how a project is behaving: how long builds take, how often they succeed, how much of your plan's build minutes and bandwidth the project is using, and where…
Configuring Redirects and Rewrites
Orbit has a built-in redirect and rewrite engine that runs before your project is asked for anything, configured either in KPanel or as a file in your repository. This guide covers both, the pattern…
Setting Environment Variables Per Environment
Orbit lets you decide exactly which builds see which environment variables, so production credentials never end up in a branch preview build. This guide covers how scope and precedence work, how to…
Triggering Deployments Via Deploy Hooks
A deploy hook is a secret URL that queues a new deployment when something sends it an HTTP POST. There is no authentication header: the secrecy of the URL is the authentication. Use hooks to let a…
Configuring Your Build Command and Output Directory
Getting Orbit to build your project correctly comes down to a handful of fields in Settings: install command, build command, output directory, root directory and Node.js version. Left blank they are…
Spending Caps and Bill-Shock Protection
Reaching your spending cap never takes your site off the internet. When a project reaches its cap we stop new builds and deploys, and the site keeps serving exactly as it was. A live site does not…
Orbit Plan Limits
Orbit has three plans, and this page documents exactly what each one includes: projects, environments, build minutes, bandwidth, build machine size, and the features that only appear on the paid…
Edge Functions
Edge functions are small JavaScript handlers that run on Kapsule's edge network before a request reaches your project, so you can do redirects, header injection, A/B routing and bot filtering…
Connecting a GitLab Repo
GitLab connects to Orbit through OAuth rather than an installed app: you authorise Kapsule once, Orbit lists the projects your GitLab account can reach, and it registers a webhook per repository so…
Connecting a Bitbucket Repo
Bitbucket connects to Orbit through OAuth: you authorise Kapsule once, Orbit lists the repositories your Bitbucket account can reach, and it registers a webhook per repository so every push triggers…
Troubleshooting Failed Builds
When an Orbit build fails, the deployment detail page gives you the full log plus a categorised failure summary and a suggested fix. This guide walks through reading that page, the failures Orbit…
Rolling Back a Deployment
If a deployment breaks production, you can put an earlier build back in front of traffic in seconds without rebuilding anything. This guide covers how rollback works, how to pick the right…
What Is Orbit?
Orbit is Kapsule's git-based deployment platform: connect a repository, push a commit, and your app builds and goes live on its own URL with a free SSL certificate, no server to configure and no…
Supported Frameworks and Runtimes In Orbit
Orbit builds any project that installs with npm, yarn or pnpm and produces a folder of files or a Node.js server, and it detects the framework and package manager for you so most projects deploy…
Environment Variables
Environment variables hold the configuration and secrets your app needs at build time and at runtime, such as API keys, database URLs and feature flags, without any of it living in your repository…
Deploying Your Project
Once a repository is connected, Orbit deploys on every push to your production branch: it clones the commit, installs dependencies, runs your build, packages the output and starts serving it. This…
Adding a Custom Domain to Your Project
Every Orbit project serves on a free kaps.run address, and you can attach your own domains alongside it with an SSL certificate provisioned automatically. This guide covers adding a domain, the DNS…
Connecting a GitHub Repo
Before Orbit can deploy anything from GitHub you install the Kapsule Orbit GitHub App on your GitHub account or organisation and choose which repositories it can see. This guide walks through the…
Viewing Build Logs
Every Orbit deployment keeps its complete build log, plus a structured breakdown of what the build did and how long each phase took. This guide covers where to find the log, how to read the…
Branch Preview Deployments In Orbit
Branch previews build every non-production, non-staging branch you push to its own isolated URL, so you can click through a change in a real environment before it merges. This guide covers turning…
Websites35
Websites: Where to Start
How website hosting works at KapsuleHost, what lives on each tab of a site, and which guide to read for the job in front of you.
Site Uptime Monitoring
Every site on KapsuleHost is checked automatically every 60 seconds, and the Uptime tab shows you the result: current status, uptime percentage, response times, and a full incident history. This…
Site Settings
The Settings tab holds the small number of site-wide switches that do not belong to any other tab: whether HTTPS is forced, whether the site is showing a maintenance page, which file is served when…
Site Security
The Security page collects every protection for a single site in one view: certificate status, malware scanning, vulnerability reports, login hardening, country filtering, hotlink protection, and an…
Storing App Secrets For a Site
The Secrets tab is an encrypted store for the sensitive configuration values a Node.js app needs, such as API keys, signing secrets and third-party tokens, kept per environment so your production…
Scaling and Auto-Scaling a Node.js App
Auto-scaling grows and shrinks the number of instances running your Node.js app as CPU load changes, so busy periods get more capacity and quiet periods cost less. This guide covers the KPanel tab…
Site Redirects
Redirects send visitors from an old URL to a new one, which is how you restructure a site without breaking every link pointing at it. This guide covers the three source shapes, choosing between 301…
Preview Deploys For Pull Requests
Preview deploys give every pull request its own live URL, built from that branch's code, so reviewers can click through the actual change instead of reading a diff and guessing. Each preview updates…
Point-in-Time Recovery
Point-in-time recovery lets you rebuild your database as it was at a chosen minute, rather than only at the moment yesterday's backup ran. This guide covers what it does and does not cover, how to…
Site Performance and APM
Application Performance Monitoring tells you where your site's time actually goes: response time percentiles, the slowest URLs, the slowest database queries, and how hard PHP is working. This guide…
Password-Protecting a Site
Password protection puts a browser sign-in prompt in front of your whole site or a specific path, which is the simplest way to keep a pre-launch site, a staging copy, or an admin area private. This…
Deploying a Site From Git
Git Deploy connects a repository to a site so that every push to your chosen branch clones the code, runs your build, and publishes the result. This guide covers the initial connection, the two…
Country Blocking for a Site
Country filtering lets you block visitors from selected countries, or allow only selected countries, enforced at the server on each visitor's IP address. This guide covers the two modes, how to set…
Custom Error Pages
A custom error page replaces the plain server default with your own branded HTML, while keeping the true error status so search engines still see a real 404. This guide covers adding a page for each…
Controlling AI Crawlers and Search Bots
The Crawlers tab controls which automated visitors are allowed to index your site, grouped into search engines, AI answer engines, SEO tools, and social preview bots. This guide explains what each…
Site Caching
Caching is the biggest single speed win available to a WordPress site: full-page caching serves finished HTML without running PHP at all, and object caching keeps database results in memory. This…
Site Traffic Analytics
The Analytics tab shows the traffic your site actually served at the edge: request counts, bandwidth, cache hit ratio, visitor countries, and response codes. This guide explains what the numbers…
Managed Addons: Postgres and Redis
The Addons tab lets you attach a managed PostgreSQL database or a managed Redis instance to a site without building or maintaining a server for it. Kapsule provisions it, gives you a connection…
Site Activity Log
The Activity log is the per-site record of what has been done and by whom: every backup taken, PHP version changed, domain added, cache purged, SSH key installed and password reset, in one…
Connecting To Your Database Over an SSH Tunnel
Your site's MySQL server only listens on the server's own loopback address, so a desktop tool such as TablePlus, Sequel Ace, DBeaver or MySQL Workbench cannot dial it directly. An SSH tunnel gives…
Connecting to Your Database Remotely
Where to find your database credentials, why direct remote connections on port 3306 are refused, and how to connect a desktop tool through an SSH tunnel instead.
The Apps Catalogue
The Apps catalogue is a browsable library of web applications you can put on a site you already host with Kapsule, from WordPress and WooCommerce to wikis, analytics, file sync and automation tools.
Installing an App on Your Site
The Apps install wizard takes three steps: configure the admin account and site settings, review what is about to happen, then watch the install run and collect your login details.
Adding SSH Keys To a Site
SSH access to a Kapsule site is key-based only, so before you can open a shell or an SFTP session you need to register a public key against the site in KPanel. This guide covers where that lives…
Fixing Mixed Content Warnings After Enabling HTTPS
When SSL is active but the browser padlock is missing, broken or showing a warning, the cause is almost always mixed content: the page itself is encrypted but something on it is still being fetched…
Setting Up and Managing Cron Jobs
A cron job runs a command on a schedule, in the background, whether or not anyone is visiting your site. This guide covers adding one in KPanel, writing the schedule and the command correctly for…
Accessing Your Database With phpMyAdmin
Every Kapsule website with a database gets browser based database access through phpMyAdmin, opened with single sign-on so there is no second password to keep. This guide covers opening it, reading…
Migrating a Website From cPanel to KapsuleHost
Most people move a site from cPanel without touching a file: Kapsule has a guided migration that copies your files and database for you while the old site stays live. This guide covers the three…
Improving Your Website Loading Speed
A fast website improves user experience, reduces bounce rates, and can positively affect search engine rankings. This guide covers the most effective steps you can take to speed up your Kapsule…
Using the File Manager in KPanel
The KPanel File Manager lets you work with your website files directly in your browser. You can browse directories, upload files, create new files and folders, edit code, and delete items, without…
Accessing Your Website Error Logs
Error logs record problems that occur on your website, including PHP errors, failed database connections, and plugin issues. When something goes wrong on your site, the error log is often the…
Pointing Your Domain to Your Website
By default, your Kapsule website is accessible at a temporary subdomain. To make it available at your own domain (for example, www.yourdomain.com), you need to add the domain in KPanel and update…
Using Staging Environments
A staging environment is a private copy of your website where you can test changes, updates, or new features without affecting your live site. Once you are happy with the result, you can push the…
Creating Your First Website
KPanel makes creating a website a short, guided process. This article walks you through every step: choosing a site type, assigning a domain, selecting your PHP version, and knowing what to expect…
Changing Your PHP Version
PHP is the programming language that powers WordPress and most other web applications hosted on KapsuleHost. The version your site runs on affects both compatibility with plugins and themes, and…
Email22
Email client setup: IMAP, SMTP, and mobile
Settings for Apple Mail, Outlook, Thunderbird, Gmail, and mobile.
Migrate your email to KapsuleHost (self-serve wizard)
Move mailboxes from Gmail, Microsoft 365, iCloud, or any IMAP host into KapsuleHost yourself, with a live progress monitor and without taking your email offline.
Shared Inboxes for Team Addresses
A shared inbox is an address like support@ or info@ that several people on your team read and reply from together, each signing in with their own mailbox credentials rather than passing one password…
Email Sending Limits
Kapsule applies sending caps to every mailbox so that one compromised account or one runaway script cannot damage the sending reputation that everybody else's mail depends on.
Email: Where to Start
How email at your own domain works on KapsuleHost, the difference between a mailbox and the four cheaper things that look like one, and which guide to read for each job.
Email Migration: Moving Your Mail to Kapsule
How to copy existing mailboxes from another provider into KapsuleHost, mailbox by mailbox, without losing mail or taking your email offline.
Mailing Lists
A mailing list is a single address at your domain that delivers a copy to everyone in the group, and unlike the other fan-out features it can be made public so people subscribe and unsubscribe…
My Mailbox Is Full
A mailbox that reaches its storage limit stops accepting new mail, so the fix is either to clear space or to raise the quota, and KPanel shows you exactly where you are against the limit on every…
Importing Mailboxes in Bulk
When you are setting up email for a whole team at once, the Import screen lets you paste a list of addresses and create every mailbox in one pass instead of running the new-mailbox wizard over and…
Distribution Groups
A distribution group is one address at your domain that fans out to several people, so mail to an address like team@ or billing@ reaches everyone on the list without anybody having to remember who…
Catch-All Addresses
A catch-all delivers mail sent to any address at your domain into one mailbox, even when the address does not exist, so a message to saels@ instead of sales@ still reaches somebody instead of…
Understanding Bounce Messages and SMTP Codes
When a message cannot be delivered you get a bounce, and buried in it is a numeric code that tells you exactly why, whether it will ever succeed, and whose end the problem is at.
Getting Delisted From a Blocklist
If legitimate mail is being rejected outright rather than filed into junk folders, your domain or the address you send from may be listed on a blocklist, and this article shows you how to confirm…
Accessing Your Email via Webmail
Every Kapsule mailbox comes with browser-based webmail at webmail.kapsulehost.com, so you can read and send mail from any device without configuring a mail app at all.
Why Are My Emails Going to Spam?
Mail from your domain landing in junk folders is almost always an authentication problem or a reputation problem, and KPanel can diagnose and fix most of the authentication half for you in a few…
IMAP vs POP3: Which Should I Use?
When you add a Kapsule mailbox to a mail app it asks whether to connect over IMAP or POP3, and for almost everybody the correct answer is IMAP.
Troubleshooting Email Not Arriving
If emails sent to your Kapsule address are not arriving, there are several places to check. Work through these steps in order to identify and resolve the issue.
SPF, DKIM, and DMARC Explained
SPF, DKIM, and DMARC are three DNS-based email authentication standards that help protect your domain from being used in phishing attacks and improve the deliverability of your legitimate emails…
Setting Up Email on iPhone and Android
You can access your Kapsule email on any smartphone using IMAP. This guide covers setup for the built-in iOS Mail app and the Gmail app on Android.
Email Aliases
An email alias is an additional address that delivers mail into an existing mailbox. For example, you might have one mailbox for jane@yourdomain.com but also want to receive mail sent to…
Setting Up Email Forwarding
Email forwarding lets you receive emails sent to your Kapsule address (for example, hello@yourdomain.com) directly in another inbox, such as Gmail or Outlook. Forwarded emails arrive in your…
Configuring Your Email in Outlook, Apple Mail, and Mobile
This guide gives you the server settings and step-by-step setup instructions for every major email client. Use the settings box at the top as your single reference, then follow the guide for your…
Cloud Servers20
Additional IPv4 Addresses
How to buy an extra dedicated IPv4 address for a KapsuleHost server, what it is genuinely useful for, and what it will not do.
Storage Servers Overview
Storage servers are bare-metal machines built around very large disk capacity rather than raw compute, with no egress fees on the data you pull back out. This guide covers the three tiers, what they…
GPU Servers Overview
GPU servers are single-tenant bare-metal machines fitted with NVIDIA accelerators, sized for AI training, inference, and rendering. This guide covers the four tiers, how ordering and delivery…
Dedicated Servers Overview
A dedicated server gives you an entire physical machine to yourself, with no other customers sharing its CPU, memory, or disks. This guide explains what Kapsule dedicated servers are, the tiers we…
Ordering a Dedicated Server
Ordering a dedicated server is a build request rather than an instant provision, so this guide walks through choosing a tier, what happens after you pay, how to read the provisioning tracker, and…
Managing a Dedicated Server
The Manage page collects every hardware-level control for a dedicated server in one place: power, rescue, reverse DNS, IP addresses, traffic, firewall, and a full operating system reinstall. This…
Dedicated Server Console Access
When a dedicated server will not boot or has lost its network, SSH is no longer an option and you need a console attached to the machine itself. This guide explains the two console routes Kapsule…
Cloud Servers Overview
Cloud servers are virtual machines you provision in minutes, resize when your workload changes, and manage from KPanel with full root access. This guide covers the three families, the sixteen tiers…
Storage Servers
A Storage Server is a single-tenant physical machine built around very large disks, sold for capacity rather than raw CPU, and with no charge for reading your own data back out.
Regions, Availability and the Reserve Queue
KapsuleHost Servers run in six regions across Europe, the United States and Singapore, and which of them you can choose depends on the processor family you pick.
Cloud Server Pricing and GST
Cloud server prices are shown excluding GST in your account's billing currency, and the same figure the panel shows you is the figure the charge is built from, so there is no gap between the price…
Managed Compared With Unmanaged Cloud Servers
Every KapsuleHost Server tier is sold in two forms, unmanaged Cloud VPS and Managed Cloud Servers, and the only difference between them is who does the system administration.
GPU and AI Compute Servers
A Kapsule GPU server is a single-tenant physical machine fitted with NVIDIA graphics processors and the CPU, memory and fast storage needed to keep them fed, built for AI training, inference and…
Choosing Between ARM, Standard and Dedicated vCPU Servers
KapsuleHost Servers come in three processor families, and the right one for you is decided by three questions: does your software run on ARM, which region do you need, and does your workload need…
Connecting to Your Cloud Server With SSH
SSH gives you a root shell on your cloud server from your own terminal, and every detail you need to connect is shown on the server's page in KPanel, ready to copy.
Cloud Server Snapshots
A snapshot is a copy of your server's entire disk at one moment in time, and rolling back to one returns the whole machine to exactly that state, which makes it the fastest way to undo a change that…
Resizing Your Cloud Server
Resizing moves your server up or down the ladder of tiers within its own processor family, changing CPU, memory and disk without moving your data or changing your IP addresses.
Rebuilding Your Cloud Server
Rebuilding reinstalls the operating system from scratch on your existing server, which erases the disk completely and gives you a clean machine on the same IP addresses.
Cloud Server Firewall and Security Management
Every KapsuleHost Server ships with a managed firewall that denies inbound traffic by default, plus brute-force protection, a web application firewall and automatic security patching, all controlled…
Cloud Server Backups
Every KapsuleHost Server is backed up to encrypted offsite storage once a day and kept for 30 days, and you can take an extra backup or restore one at any time from the server's own page in KPanel.
Domains & DNS17
Domain DNS and nameservers explained
How to point your domain to KapsuleHost, update nameservers, and manage DNS records.
Site Domains Tab
The Domains tab is where you attach domain names to a site, decide which one is the primary URL, and check whether DNS has caught up yet. A site can carry several domains at once, with one of them…
WHOIS Privacy
WHOIS privacy replaces your personal contact details in the public domain registration record with a privacy service, and at Kapsule it is included free on every domain that supports it, with no…
Looking Up Domain Registration Details
KPanel has a WHOIS lookup that tells you whether a domain is registered, who holds it, when it expires, and which nameservers it uses, and it works for any domain, not just the ones on your account.
Subdomains and Parked Domains
A subdomain is just a DNS record under your domain, and a parked domain is one you own but are not hosting a site on, and KPanel handles both from the domain page without any separate product to buy.
Domain Renewal, Expiry and Recovery
A domain is a lease rather than a purchase, and letting it lapse takes your website and your email down together, so this article covers how renewal works at Kapsule, what the panel tells you, and…
Domains: Where to Start
Everything you can do with a domain name at KapsuleHost, and which guide to read for each job.
Glue Records and Custom Nameservers
Glue records solve one specific circular-lookup problem in DNS, and because Kapsule's nameservers live on domains of their own rather than on yours, almost nobody hosting with us ever needs one.
Getting Your Domain Auth Code
An auth code is the password that proves you control a domain, and every transfer between registrars needs one, so knowing where to get yours and what to do when it is rejected saves most of the…
Updating Your Domain Contact Details
Every domain registration carries a registrant contact record, the registry requires it to be accurate, and KPanel lets you edit it from the domain's Overview tab.
Bulk Domain Search
Bulk search checks a whole list of domain names at once and puts everything available into your cart in a single action, which beats searching fifty names one at a time when you are choosing a brand…
Transferring Your Domain to Another Registrar
You can move any domain registered with Kapsule to another registrar whenever you want, and the auth code you need to do it is one button away in KPanel.
Registering and Managing .nz Domains
New Zealand's .nz namespace runs on its own registry rules, and several of them differ enough from .com that the KPanel controls you expect to see are deliberately absent on a .nz domain.
Enabling DNSSEC for Your Domain
DNSSEC signs your DNS zone cryptographically so that resolvers can prove an answer really came from you, and Kapsule can turn it on for any domain whose DNS we host.
Transferring a Domain to Kapsule
Transferring your domain to Kapsule brings your domain registration and hosting under one roof, making it easier to manage DNS, renewals, and email. The process typically takes two to seven days.
Changing Nameservers to Point Your Domain to Kapsule
Updating your nameservers is the most important step in connecting an existing domain to KapsuleHost. This guide covers what nameservers do, Kapsule's nameserver addresses, how to make the change at…
Adding and Connecting Your Domain
Your domain is the address people use to find your website. This guide covers two scenarios: registering a brand new domain through KapsuleHost, and connecting a domain you already own at another…
Billing & Plans16
Reactivating Your Account
You want to come back, and the only question that matters is what is still recoverable, what is already gone, and what it costs to pick it up again. The answer depends entirely on how far down the…
What Happens If You Stop Paying
If a payment stops going through, nothing is deleted on the day it fails and nothing is deleted quietly later. There is a published sequence, every step of it sends you an email, and most of it is…
Renewals and Auto-Renew
Kapsule subscriptions renew automatically by default. There is no auto-renew switch to find, because renewal is the normal state: you opt out by cancelling, and you opt back in by keeping the…
Reading Your Invoice
Every charge Kapsule makes produces two records that describe the same transaction from different angles: an order, which is what you bought, and an invoice, which is the document your accountant…
Proration and Plan Changes
When you move between plans, Kapsule works out the exact amount before anything is charged, shows it to you, and waits for you to confirm.
Payment Options and Saved Cards
Kapsule bills by card. A saved card is what makes automatic renewals work, and keeping a valid one on file is the single most effective thing you can do to avoid an interrupted service.
Understanding Your Billing Page
The Billing page is the single place your money lives: what you pay each month, what is due next, which cards are on file, and every order and invoice you have ever had.
GST and Tax Invoices
New Zealand GST of 15 percent is added to your charges when your account currency is NZD, and to no other currency.
Your Billing Currency
Every Kapsule account is billed in one currency, chosen when you sign up, and that currency is fixed permanently once you have been charged for the first time.
Adding or Changing Your Payment Method
Your saved cards live on one page in KPanel, and each subscription separately decides which of those cards its renewal charges land on.
The 30-Day Money-Back Guarantee
Kapsule backs its hosting subscriptions with a 30-day money-back guarantee, and inside that window you can process the refund yourself from KPanel without waiting on anyone.
What Happens When a Payment Fails
When a renewal charge is declined, nothing is switched off straight away: Kapsule emails you, retries the charge automatically, and gives you a graded window to fix the card before anything stops…
Cancelling Your Plan
You can cancel any Kapsule subscription yourself from KPanel, and by default your services keep running until the end of the billing period you have already paid for.
Upgrading or Changing Your Hosting Plan
You can change your hosting plan at any time from KPanel. Whether you are growing into a larger plan or adjusting to a different tier, the process is straightforward and billing is handled…
Billing, Invoices, and Managing Your Plan
This guide covers everything related to your subscription, payments, and invoices in KPanel.
Cancelling Your Account and Refund Policy
This guide explains how to cancel your subscription, what happens to your data after cancellation, and how the 30-day money-back guarantee works.
WordPress15
WordPress: Where to Start
What KapsuleHost does for a WordPress site, what you still do yourself, and which guide to read for each job.
WordPress Auto-Updates
Auto-updates keep WordPress core, plugins and themes current without you watching for release notes, and they do it safely: a full backup is taken before every update, the site is checked…
Payment Gateways For a WooCommerce Store
The Payments tab lists the payment gateways available to your WooCommerce store, shows which are installed and which are switched on, and gives you one-click install and enable so you can go from a…
Increasing the WordPress Memory Limit
When WordPress or a plugin dies with a memory exhaustion error, the fix is to raise the PHP memory limit, and on Kapsule that is a dropdown in KPanel rather than a file edit. This guide covers what…
Understanding .htaccess on KapsuleHost
Kapsule serves every website with a high performance web server that does not read .htaccess, so rules you add to that file have no effect: this guide explains what that means for a WordPress site…
Running a Search and Replace in Your WordPress Database
WordPress stores absolute URLs in dozens of database tables, so a domain change or an SSL move leaves old addresses scattered through posts, options and plugin settings: a search and replace is how…
Resetting a Lost WordPress Admin Password
If you cannot get into wp-admin, KPanel gives you three ways back in without touching the database by hand, and this guide covers each one, when to use it, and how to get in when your site cannot…
Using Staging: Pushing to Production and Pulling From Production
Once a staging copy exists, two operations keep it useful: pushing your tested changes up to the live site, and resetting staging back to a fresh copy of production. This guide covers both…
Using WP-CLI on Your WordPress Site
KPanel includes a WP-CLI console that runs commands against your WordPress site from the browser, with no SSH client and no server login. This guide covers where to find it, exactly which commands…
Setting Up WooCommerce on KapsuleHost
Kapsule has a dedicated WooCommerce site type that installs WordPress, WooCommerce and a set of New Zealand payment gateways for you, then adds store specific tools to the site menu. This guide…
Fixing the WordPress White Screen of Death
The "white screen of death" is when your WordPress site displays a blank white page with no error message. It is one of the more frustrating WordPress issues because it gives no visible clue about…
Keeping WordPress Up to Date
Keeping WordPress core, your plugins, and your themes updated is the single most important thing you can do to keep your website secure. Outdated software is the leading cause of compromised…
Installing and Managing WordPress Plugins
Plugins extend what WordPress can do, from contact forms and SEO tools to online stores and performance optimisation. This guide covers how to manage plugins effectively and safely on your Kapsule…
Fixing WordPress Permalink and 404 Issues
If your WordPress pages are returning 404 errors when they should exist, or links within your site are broken after a migration or plugin change, the most common fix is to flush (regenerate) your…
WordPress Admin Access and Credentials
This article covers everything related to getting into your WordPress admin panel: finding the login URL, recovering a forgotten password, getting back in after a lockout, managing admin users, and…
Getting started14
Free migration from another host
How the free migration tools work, what Kora does with you, and when a person does the move instead.
How to get support
Ways to reach the KapsuleHost team and what to expect.
Migrations: Moving to KapsuleHost
How to move an existing website, mailbox or domain to KapsuleHost, what the self-serve wizard does for you, and where the paid managed service fits.
Kora Settings
Kora has one setting of its own, the language it replies in, and this guide covers where it lives, how auto-detect behaves, and how the setting relates to the language of KPanel itself.
Kora Conversation History
Kora keeps a summary of your past conversations so it can help without making you repeat yourself, and this page is where you review that memory, rate it, and erase it.
Kora Actions and Approvals
Kora answers questions and reads your account instantly, but anything that changes your account stops and asks you to type a confirmation phrase back before it runs.
Hosting Glossary: Every Term Explained
A plain-English dictionary of the hosting, DNS, email and infrastructure terms that appear across KapsuleHost and this help centre.
Using Agent Skills
A skill turns a task into a finished deliverable: you pick the job, answer two or three plain questions, check the brief, and the expert produces the result rather than a conversation about it.
Kapsule Agents Overview
Kapsule Agents is a team of seven AI specialists inside KPanel that draft, plan and research for your business, and that can act on your Kapsule account once you confirm the change.
Getting Started With Kapsule Agents
This walkthrough takes you from opening Agents for the first time to a finished piece of work, covering the welcome questions, picking the right expert, the chat surface, and what happens when your…
How Agent Credits Work
Credits are the meter behind Kapsule Agents and Kora: reading your account is always free, and you only spend when an expert produces finished work or makes a change you confirmed.
Connecting External Apps to Your Agents
Connections let a Kapsule Agents expert work inside apps you already use, with your permission, and they are entirely separate from what an expert can do on your Kapsule account.
Migrating Your Website to Kapsule
Moving your website to Kapsule is straightforward, and we offer free migration assistance for eligible sites. This guide explains both the assisted migration process and how to complete a…
How Kora Works: Your AI Support Assistant
Kora is the AI assistant built directly into KPanel. It can answer questions about your account, walk you through tasks, and take actions on your behalf, all through a natural conversation.
Account10
Leaving Kapsule: Taking Everything With You
This is the complete checklist for moving your websites, files, databases, mailboxes and domains to another provider, in the order that keeps all of it intact. Almost every route out is…
Insights: Problems Found Before You Notice Them
The automatic checks KapsuleHost runs across your sites, domains and account, and what to do with what they find.
API Keys and Developer Access
Kapsule gives you two developer surfaces: scoped API keys for reading your account programmatically, and a remote build cache that speeds up Turborepo and Nx builds on your own machines and CI…
Closing Your Kapsule Account
Closing an account is the end of a sequence, not a single button: services get cancelled, domains get moved or released, data gets exported, and only then does the account itself get closed.
Changing the Email Address on Your Account
Your account email is both your sign-in identity and the address every security and billing message goes to, so changing it is a verified, two-sided process rather than a simple edit.
Inviting Team Members and Setting Roles
Your Kapsule account can be shared with colleagues, contractors, and accountants by sending each of them an email invitation and giving them a role that decides exactly what they can see and change.
Why Your Account Was Suspended
Suspension is a pause, not a deletion. Your sites stop serving, but nothing has been erased and mail keeps flowing, and the great majority of suspensions clear the moment the underlying cause is…
Managing Your Email Notifications
Kapsule sends two very different kinds of email: the ones that keep your account running, which are always on, and the optional ones you can switch off whenever you like.
Reading Your Account Audit Log
The audit log is a permanent, filterable record of every action taken inside your Kapsule account, showing who did it, what they touched, when, and from which IP address.
Securing Your Account: Password and Two-Factor Authentication
Your KPanel account controls access to your sites, domains, billing, and backups. This guide covers every security measure you should have in place.
Security9
What to Do If Your Site Is Hacked
A compromised website needs three things in order: contain it, find out how they got in, then rebuild it clean. Doing those out of order is how sites get reinfected within a day.
Security: Where to Start
The security controls KapsuleHost gives you, the ones you have to switch on yourself, and what to do first if something has already gone wrong.
Reporting Abuse
If something hosted on Kapsule is being used to send spam, host a phishing page, distribute malware, infringe copyright, or break the law, report it to abuse@kapsulehost.com.
Kapsule Protect Overview
Kapsule Protect is the umbrella name for the five add-on products that make a site production-grade: extended backups, Premium DNS, SSL, Kapsule Care and Pro Services.
Phishing and Impersonation
Hosting accounts are a high value target, so people will try to impersonate Kapsule to get your password. This page tells you exactly what a genuine message from us looks like, what we will never…
Scanning For and Removing Malware
Every hosted site is scanned for malware automatically each night, and you can run a scan yourself at any time from the site's Security tab.
Lost Access to Your Account Email
Your account email is your sign-in identity and the destination for every password reset and security code, so losing access to it is the one lockout you cannot solve inside the panel.
Lost Your Two-Factor Device
If you cannot produce a six-digit code at sign-in, a recovery code will get you back in. Read this page before you need it, because the single most useful step happens while you still have access.
Setting Up Two-Factor Authentication
Two-factor authentication (2FA) adds a second verification step when you log in to KPanel. Even if someone obtains your password, they cannot access your account without also having access to your…
Hosting & sites6
Installing WordPress on your site
One-click WordPress setup in KPanel, plus WooCommerce and plugins.
Git deploy: push to deploy your site
Connect GitHub or GitLab to auto-deploy your site on every push.
Changing the PHP version for your site
How to switch PHP versions per site and which version to use.
Kapsule Care for WooCommerce
Kapsule Care WooCommerce is a managed care plan built around the one thing a store cannot afford to have broken: the order flow, tested after every update.
Kapsule Care Overview
Kapsule Care is hands-on website management: our engineers apply your updates, watch your site, log real support hours against your account, and publish a health report every month.
Setting Up Your Care Plan
After you subscribe to Kapsule Care, a short onboarding form tells our team which site to manage, how to get access, and what to prioritise, so the first review starts on the right foot.
DNS6
Site DNS Tab
The DNS tab shows the live DNS records for the domain attached to a site, so you can check what a name currently resolves to without leaving the site you are working on. It is a read-only view…
Premium DNS
Premium DNS upgrades a single domain's zone to anycast resolution with health-checked failover, so visitors are answered from the nearest node and a dead origin is removed from DNS automatically.
Domain Verification Records
How to prove you own a domain, whether the service asking is KapsuleHost, Google, Microsoft or anyone else, and how to add the record in KPanel.
Setting Up CNAME Records for Subdomains
A CNAME (Canonical Name) record maps one domain name to another. It is commonly used to point a subdomain to a third-party service, such as shop.yourdomain.com pointing to your Shopify store, or…
Pointing Your Domain Email to Kapsule
MX (Mail Exchanger) records tell the internet which mail server handles email for your domain. If you want to use Kapsule mailboxes for your domain, you need to ensure your domain's MX records point…
DNS Basics: A Records, MX, CNAME, and TXT Explained
DNS is one of those things that works invisibly when everything is correct, and becomes critical to understand when something is wrong. This article explains what DNS is, what each record type does…
Troubleshooting5
Site Down: Matching What You See to the Cause
This is the cross-product triage tree for a site that will not load. Kapsule runs several products, and the fastest way to find the cause is not to guess which one is at fault, but to look closely…
Using Cloudflare or Another Proxy With Kapsule
How to put a third-party proxy or CDN in front of a KapsuleHost site, including the two settings that break sites, the records that must never be proxied, and how to undo it.
Site Slowness and Resource Limits
What your hosting plan actually limits, what happens when you reach each limit, and how to work out whether a slow site is a resource problem or a code problem.
PHP Extensions and Settings
Which PHP versions and extensions KapsuleHost web hosting provides, which settings you can change yourself, and why a change can take up to five minutes to appear.
HTTP Error Codes on KapsuleHost
What 403, 404, 500, 502, 503 and 504 actually mean on this platform, and the specific thing to do about each one.
Support3
Status and Uptime: Is It Us or Is It You
How to tell whether a problem is with the KapsuleHost platform or with your own site, using the public status page and the uptime monitoring built into KPanel.
Pro Services
Pro Services lets you hand a specific job to the engineers who run your hosting: migrations, WordPress work, DNS surgery, SEO, security audits and custom development, each priced before work begins…
Opening a Support Ticket
Kora handles most common tasks instantly, but some situations need a human. This guide explains how to reach the support team and how to write a ticket that gets resolved quickly.
CDN2
Enabling Kapsule CDN on Your Site
Kapsule CDN caches your site at the edge so visitors anywhere in the world are served from a nearby location instead of your origin server, and turning it on is a single toggle on the site you want…
Purging the Kapsule CDN Cache
Purging clears the copy of your content held at the edge so the next visitor gets a freshly fetched version from your origin, which is what you do when you have published a change and the old…
Backups2
Taking a Backup
Every site on KapsuleHost is backed up automatically once a day, and you can take a manual backup at any time. This guide covers where backups live in KPanel, how to create one on demand, what each…
Restoring Your Site from a Backup
If your site is broken after an update, has been compromised, or content has been accidentally deleted, restoring from a backup is often the fastest way to get back to a working state. This guide…
FAQs by topic
Common questions, by product
Every product page has detailed FAQs at the bottom. Start there for product-specific questions.