Guidelines for migrating sites from another hosting provider to Cito
Cito is designed to support automatic migration from other control panels, most notably cPanel. We also offer managed migrations to all customers.The Migrations page (under ‘Tools’) has three options:
Migrating using WHM credentials. This requires root or sudo-capable credentials, or an SSH key. Best suited if you have multiple sites to move.
Migrating using a cPanel backup. This allows you to upload a cPanel backup file (known as a cpmove file, ending in .tar.gz) to import a single site at a time
“Not sure”. This opens a ticket with our onboarding department, for our team to manage the migration process for you.
Migrating using WHM credentials
This step requires root-level credentials (or Sudo access) to allow you to import multiple sites from cPanel & WHM based servers. We connect via SSH to analyse the server and retrieve a list of domains. You should ensure the source server’s SSH port is accessible and not blocked by a firewall.You can review the list of domains and select the ones you wish to migrate.Domains must have a matching PHP version on the server to move them. If you are attempting to move a site which uses a PHP version not installed on the server, you will see an error- please contact Support if you need additional versions installed.We automatically attempt to detect the site type, but if you wish, you can set your own using the dropdown menu in the site list:
Preview URLs
When we migrate a site, we automatically generate a preview URL, and check this URL for a 200 OK response code. We’ll indicate if we receive this with a status badge.If the preview URL does not return a 200 OK response, the badge will show an error:You should review these errors and compare them against the source server.
What about subdomains, or parked domains?We automatically detect subdomains or parked domains. These can be imported as either separate sites, or as Aliases.
Migrating using a cPanel backup
You can also migrate using cPanel-format archive files, which can be generated from the “Backups” section in the source server’s control panel.You should select “Download a Full Account Backup” and follow the steps in cPanel to download the archive file. These files usually start with backup and have a .tar.gz extension.You can only migrate one site at a time using this method. If you have multiple sites to move, you may wish to use the WHM method detailed above.Note that we cannot detect PHP versions inside these files, which means you will need to select your sites existing PHP version when migrating.We automatically attempt to detect the site type, such as Wordpress, but if you wish you can set your own using the dropdown menu in the site list.
”Not sure”
This opens a ticket in our onboarding department. We can carry out a managed migration on your behalf using details you supply.Our team will audit the existing server, and propose a migration plan. Note that managed migrations are carried out on a best-effort basis; our team will advise if there are any issues with moving your sites over.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Prostack Cito","colors":{"primary":"#1C1F38","light":"#3B4063","dark":"#0F1120"},"logo":{"light":"/logo/logo.png","dark":"/logo/logo.png"},"favicon":"/logo/logo.png","appearance":{"default":"light"},"navbar":{"links":[{"href":"https://feedback.cito.prostack.uk/","label":"Feedback"}],"primary":{"type":"button","label":"Log into Cito","href":"https://cito.prostack.uk"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/prostackhost","x":"https://x.com/prostackhost"}},"integrations":{"telemetry":{"enabled":false}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"hasAudioNarration":false,"customDomains":[],"gitSource":{"type":"github","owner":"local","repo":"local","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"local","isBase":true},"buildId":"local","clientVersion":"0.0.4203"},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false,"isLoggedInCli":false,"mintExport":{}},"customCss":[{"filePath":"style.css","content":":root{--background: #f9f9f9 !important;--bg-background: #f9f9f9 !important;--background-light: 249 249 249 !important;--navbar-background: #f9f9f9 !important}html:not(.dark){background-color:#f9f9f9}html:not(.dark) body{background-color:#f9f9f9}html:not(.dark) #content-container{background-color:#f9f9f9}html:not(.dark) #navbar,html:not(.dark) nav,html:not(.dark) header,html:not(.dark) [class*=\"Navbar\"],html:not(.dark) [class*=\"navbar\"],html:not(.dark) [class*=\"Header\"],html:not(.dark) [class*=\"header\"],html:not(.dark) [class*=\"TopBar\"],html:not(.dark) [class*=\"topbar\"],html:not(.dark) [class*=\"nav-\"],html:not(.dark) [class*=\"scroll\"],html:not(.dark) [class*=\"sticky\"]{background-color:#f9f9f9!important;background:#f9f9f9!important;backdrop-filter:none!important;-webkit-backdrop-filter:none!important}html:not(.dark) [class*=\"Navbar\"]::before,html:not(.dark) [class*=\"Navbar\"]::after,html:not(.dark) header::before,html:not(.dark) header::after,html:not(.dark) nav::before,html:not(.dark) nav::after{background-color:#f9f9f9!important;background:#f9f9f9!important}header a[href=\"/\"],[class*=\"Navbar\"] a[href=\"/\"]{display:inline-flex;align-items:center;gap:0.5rem}header a[href=\"/\"]::after,[class*=\"Navbar\"] a[href=\"/\"]::after{content:\"Cito Documentation\";font-weight:600;font-size:1.1rem;color:#1C1F38;white-space:nowrap}html.dark header a[href=\"/\"]::after,html.dark [class*=\"Navbar\"] a[href=\"/\"]::after{color:white}"}],"page":{"pagePath":"getting-started/migration","slug":"/getting-started/migration","pageMetadata":{"title":"Migrating from another host","description":"Guidelines for migrating sites from another hosting provider to Cito","href":"/getting-started/migration"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Guidelines for migrating sites from another hosting provider to Cito\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,img:`img`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Cito is designed to support automatic migration from other control panels, most notably cPanel. We also offer managed migrations to all customers.`}),`\n`,_jsx(_components.p,{children:`The Migrations page (under ‘Tools’) has three options:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Migrating using WHM credentials.`}),` This requires root or sudo-capable credentials, or an SSH key. Best suited if you have multiple sites to move.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Migrating using a cPanel backup.`}),` This allows you to upload a cPanel backup file (known as a `,_jsx(_components.code,{children:`cpmove`}),` file, ending in `,_jsx(_components.code,{children:`.tar.gz`}),`) to import a single site at a time`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`“Not sure”.`}),` This opens a ticket with our onboarding department, for our team to manage the migration process for you.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.img,{src:`/images/screenshots/migration-methods.png`,alt:`Migration methods`})}),`\n`,_jsx(Heading,{level:`2`,id:`migrating-using-whm-credentials`,children:`Migrating using WHM credentials`}),`\n`,_jsx(_components.p,{children:`This step requires root-level credentials (or Sudo access) to allow you to import multiple sites from cPanel \u0026 WHM based servers. We connect via SSH to analyse the server and retrieve a list of domains. You should ensure the source server’s SSH port is accessible and not blocked by a firewall.`}),`\n`,_jsx(_components.p,{children:`You can review the list of domains and select the ones you wish to migrate.`}),`\n`,_jsx(_components.p,{children:`Domains must have a matching PHP version on the server to move them. If you are attempting to move a site which uses a PHP version not installed on the server, you will see an error- please contact Support if you need additional versions installed.`}),`\n`,_jsx(_components.p,{children:`We automatically attempt to detect the site type, but if you wish, you can set your own using the dropdown menu in the site list:`}),`\n`,_jsx(_components.p,{children:_jsx(_components.img,{src:`/images/screenshots/migration-typeselector.png`,alt:`Migration Type Select`})}),`\n`,_jsx(Heading,{level:`3`,id:`preview-urls`,children:`Preview URLs`}),`\n`,_jsxs(_components.p,{children:[`When we migrate a site, we automatically generate a preview URL, and check this URL for a `,_jsx(_components.code,{children:`200 OK`}),` response code. We’ll indicate if we receive this with a status badge.`]}),`\n`,_jsxs(_components.p,{children:[`If the preview URL does not return a `,_jsx(_components.code,{children:`200 OK`}),` response, the badge will show an error:`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.img,{src:`/images/screenshots/migration-complete.png`,alt:`Preview URL`})}),`\n`,_jsx(_components.p,{children:`You should review these errors and compare them against the source server.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`What about subdomains, or parked domains?`})}),_jsx(_components.p,{children:`We automatically detect subdomains or parked domains. These can be imported as either separate sites, or as Aliases.`})]}),`\n`,_jsx(Heading,{level:`2`,id:`migrating-using-a-cpanel-backup`,children:`Migrating using a cPanel backup`}),`\n`,_jsx(_components.p,{children:`You can also migrate using cPanel-format archive files, which can be generated from the “Backups” section in the source server’s control panel.`}),`\n`,_jsxs(_components.p,{children:[`You should select “Download a Full Account Backup” and follow the steps in cPanel to download the archive file. These files usually start with `,_jsx(_components.code,{children:`backup`}),` and have a `,_jsx(_components.code,{children:`.tar.gz`}),` extension.`]}),`\n`,_jsx(_components.p,{children:`You can only migrate one site at a time using this method. If you have multiple sites to move, you may wish to use the WHM method detailed above.`}),`\n`,_jsx(_components.p,{children:`Note that we cannot detect PHP versions inside these files, which means you will need to select your sites existing PHP version when migrating.`}),`\n`,_jsx(_components.p,{children:`We automatically attempt to detect the site type, such as Wordpress, but if you wish you can set your own using the dropdown menu in the site list.`}),`\n`,_jsx(Heading,{level:`2`,id:`”not-sure”`,children:`”Not sure”`}),`\n`,_jsx(_components.p,{children:`This opens a ticket in our onboarding department. We can carry out a managed migration on your behalf using details you supply.`}),`\n`,_jsx(_components.p,{children:`Our team will audit the existing server, and propose a migration plan. Note that managed migrations are carried out on a best-effort basis; our team will advise if there are any issues with moving your sites over.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Migrating from another host","description":"Guidelines for migrating sites from another hosting provider to Cito","href":"/getting-started/migration"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Migrating using WHM credentials","slug":"migrating-using-whm-credentials","depth":2,"children":[{"title":"Preview URLs","slug":"preview-urls","depth":3,"children":[]}]},{"title":"Migrating using a cPanel backup","slug":"migrating-using-a-cpanel-backup","depth":2,"children":[]},{"title":"”Not sure”","slug":"”not-sure”","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"localhost","siteName":"Prostack Cito","title":"Migrating from another host - Prostack Cito","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"getting-started/migration.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Guidelines for migrating sites from another hosting provider to Cito\">\u003cmeta data-mint-head name=\"application-name\" content=\"Prostack Cito\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/favicons/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/favicons/favicon-32x32.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/favicons/favicon-16x16.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/favicons/favicon.ico\">\u003cmeta data-mint-head property=\"og:title\" content=\"Migrating from another host - Prostack Cito\">\u003cmeta data-mint-head property=\"og:description\" content=\"Guidelines for migrating sites from another hosting provider to Cito\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Prostack Cito\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://local./getting-started/migration\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Migrating from another host - Prostack Cito\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Guidelines for migrating sites from another hosting provider to Cito\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/favicons/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Prostack Cito\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1C1F38\">\u003clink data-mint-head rel=\"canonical\" href=\"https://local./getting-started/migration\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/getting-started/migration.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Prostack Cito\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Prostack Cito\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/getting-started/migration.md","siteName":"Prostack Cito","nav":{"groups":[{"group":"Home","pages":[{"title":"Introduction","href":"/index"}]},{"group":"Getting Started","pages":[{"title":"First Steps","href":"/getting-started/index"},{"title":"Generating SSH Keys","description":"How to generate SSH key pairs for accessing Cito via command line or SFTP","href":"/getting-started/ssh-keys"},{"title":"Migrating from another host","href":"/getting-started/migration"},{"title":"Frequently Asked Questions","description":"Common questions about Cito hosting platform","href":"/getting-started/faq"}]},{"group":"Creating Sites","pages":[{"title":"Adding a New Site","href":"/creating-sites/overview"},{"title":"Installing WordPress","href":"/creating-sites/wordpress"},{"title":"NodeJS Applications","href":"/creating-sites/nodejs"},{"title":"Proxy Pass","href":"/creating-sites/proxy-pass"}]},{"group":"Containers","pages":[{"title":"Container Sites","href":"/creating-sites/docker"},{"title":"Importing from Docker Compose","href":"/creating-sites/docker-compose"},{"title":"Managing Containers","href":"/managing-sites/containers"},{"title":"Services","href":"/managing-sites/container-services"},{"title":"Converting a Proxy Pass Site","href":"/managing-sites/convert-proxy-site"},{"title":"Container Limits","href":"/managing-sites/container-limits"}]},{"group":"Managing Sites","pages":[{"title":"Sites Overview","href":"/managing-sites/overview"},{"title":"Changing PHP Versions","href":"/managing-sites/php-version"},{"title":"Custom Document Roots","href":"/managing-sites/document-root"},{"title":"Preview URLs","href":"/managing-sites/preview"},{"title":"Cloning Sites","href":"/managing-sites/clone"},{"title":"Renaming Sites","href":"/managing-sites/rename"},{"title":"Suspending Sites","href":"/managing-sites/suspend"},{"title":"Deleting Sites","href":"/managing-sites/delete"},{"title":".htaccess Import","href":"/managing-sites/htaccess-import"}]},{"group":"Domains, SSL \u0026 Email","pages":[{"title":"Aliases","href":"/managing-sites/aliases"},{"title":"Redirects","href":"/managing-sites/redirects"},{"title":"Domain Information","href":"/managing-sites/domain-information"},{"title":"SSL Certificates","href":"/cli/ssl"},{"title":"Email","href":"/managing-sites/email"}]},{"group":"Files \u0026 Databases","pages":[{"title":"File Manager","href":"/managing-sites/file-manager"},{"title":"Managing MySQL Databases","href":"/managing-sites/mysql"},{"title":"Database Ownership","href":"/managing-sites/database-ownership"},{"title":"Backups","href":"/managing-sites/backups"}]},{"group":"Security","pages":[{"title":"Password Protection","href":"/managing-sites/password-protection"},{"title":"IP Blocking","href":"/managing-sites/ip-blocking"},{"title":"Bot \u0026 Crawler Blocking","href":"/managing-sites/bot-blocking"},{"title":"Firewall","href":"/managing-sites/firewall"},{"title":"Malware Protection","href":"/managing-sites/security"}]},{"group":"Performance \u0026 Monitoring","pages":[{"title":"Caching","href":"/managing-sites/caching"},{"title":"Analytics","href":"/managing-sites/analytics"},{"title":"Viewing Logs","href":"/managing-sites/logs"}]},{"group":"Deployment \u0026 Automation","pages":[{"title":"SSH","href":"/deploying/ssh"},{"title":"Working with Git","href":"/deploying/git"},{"title":"Cron Jobs","href":"/managing-sites/crons"},{"title":"MCP Server (beta)","href":"/deploying/mcp"}]},{"group":"Server Configuration","pages":[{"title":"Nginx","href":"/cli/nginx"},{"title":"PHP","href":"/cli/php"}]},{"group":"Account","pages":[{"title":"User Management","href":"/account/authentication"},{"title":"Audit Logs","href":"/account/audit-logs"}]},{"group":"Support","pages":[{"title":"Getting Support","href":"/support/contact"},{"title":"Changelog","href":"/support/changelog"}]}]},"basePath":"","title":"Migrating from another host - Prostack Cito","buildId":"3fee6f877672","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-sgQzkCp-.js","lightbox-handle-r17bVUz3.js"]}