Automatic Let’s Encrypt SSL certificates and custom certificate options
Overview
Cito issues Lets Encrypt certificates for all sites it knows about, and will automatically renew them without requiring any user involvement. This includes domain aliases.Cito will automatically attempt to issue an SSL certificate when you create (or rename) a site, or add an alias.We are only able to validate certificates for domains that point to the server- i.e. are live on Cito. If a site does not point to the IP of your Cito server, we will not be able to validate it.If you are using a CDN service or proxy such as Cloudflare, we will not issue a certificate, as these services handle SSL themselves.
Renewals
Cito will automatically attempt to issue a certificate every few minutes for domains that do not have them. Only domains that resolve to the server will be issued certificates.Renewals are processed nightly at 02:05.
How certificates are shared
Certificate are issued on a per-account basis, which means each site and it’s aliases share a cert.Domains that do not point to the server (including the primary domain) will not block the issuance of other domains under the same site. This means, for example, that even if the main domain for a site does not point to the server, we will be able to issue a cert for its aliases.
Manually issuing a certificate
If you’ve recently pointed a domain name to the server but the renewal cron hasn’t yet run, you can force a reissue by running:
/.ps/scripts/certmon.sh
We strongly advise against running certbot commands directly. This can have unexpected results.
Bringing your own certificate
If you have your own certificate you can use this with Cito. You’ll need the SSL certificate and a matching private key - contact your SSL provider if you’re unsure how to generate this.You can then update your nginx configuration file (/etc/nginx/conf.d/<username>.conf) with the path to your certificate and key. The lines to modify are:
We recommend storing your cert and key in /etc/ssl/certs and /etc/ssl/private respectively.You can then run nginx -t to verify your configuration is correct, and systemctl reload nginx to reload and apply the certificate.
We strongly advise you use Lets Encrypt with Cito for automatic certificate renewal and management. You cannot use Aliases with a custom SSL certificate.
Wildcard certificates
Contact support if you wish to use a wildcard certificate with Cito- this requires a manual configuration change in Nginx and so must be done manually.We can help you issue a wildcard certificate and configure it on your chosen domain. We will provide a DNS TXT record which you can use to validate domain ownership.
{"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":"cli/ssl","slug":"/cli/ssl","pageMetadata":{"title":"SSL Certificates","description":"Automatic Let's Encrypt SSL certificates and custom certificate options","href":"/cli/ssl"},"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: \"Automatic Let’s Encrypt SSL certificates and custom certificate options\"\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`,em:`em`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`Cito issues Lets Encrypt certificates for all sites it knows about, and will automatically renew them without requiring any user involvement. This includes domain aliases.`}),`\n`,_jsx(_components.p,{children:`Cito will automatically attempt to issue an SSL certificate when you create (or rename) a site, or add an alias.`}),`\n`,_jsx(_components.p,{children:`We are only able to validate certificates for domains that point to the server- i.e. are live on Cito. If a site does not point to the IP of your Cito server, we will not be able to validate it.`}),`\n`,_jsx(_components.p,{children:`If you are using a CDN service or proxy such as Cloudflare, we will not issue a certificate, as these services handle SSL themselves.`}),`\n`,_jsx(Heading,{level:`2`,id:`renewals`,children:`Renewals`}),`\n`,_jsx(_components.p,{children:`Cito will automatically attempt to issue a certificate every few minutes for domains that do not have them. Only domains that resolve to the server will be issued certificates.`}),`\n`,_jsx(_components.p,{children:`Renewals are processed nightly at 02:05.`}),`\n`,_jsx(Heading,{level:`2`,id:`how-certificates-are-shared`,children:`How certificates are shared`}),`\n`,_jsxs(_components.p,{children:[`Certificate are issued on a per-account basis, which means each site and it’s aliases `,_jsx(_components.em,{children:`share`}),` a cert.`]}),`\n`,_jsx(_components.p,{children:`Domains that do not point to the server (including the primary domain) will not block the issuance of other domains under the same site. This means, for example, that even if the main domain for a site does not point to the server, we will be able to issue a cert for its aliases.`}),`\n`,_jsx(Heading,{level:`2`,id:`manually-issuing-a-certificate`,children:`Manually issuing a certificate`}),`\n`,_jsx(_components.p,{children:`If you’ve recently pointed a domain name to the server but the renewal cron hasn’t yet run, you can force a reissue by running:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`/.ps/scripts/certmon.sh`})}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`We strongly advise against running `,_jsx(_components.code,{children:`certbot`}),` commands directly. This can have unexpected results.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`bringing-your-own-certificate`,children:`Bringing your own certificate`}),`\n`,_jsx(_components.p,{children:`If you have your own certificate you can use this with Cito. You’ll need the SSL certificate and a matching private key - contact your SSL provider if you’re unsure how to generate this.`}),`\n`,_jsxs(_components.p,{children:[`You can then update your nginx configuration file (`,_jsx(_components.code,{children:`/etc/nginx/conf.d/\u003cusername>.conf`}),`) with the path to your certificate and key. The lines to modify are:`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`nginx`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`nginx`,children:_jsxs(_components.code,{language:`nginx`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`ssl_certificate `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/path/to/certificate;`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`ssl_certificate_key `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/path/to/certificate_key;`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`We recommend storing your cert and key in `,_jsx(_components.code,{children:`/etc/ssl/certs`}),` and `,_jsx(_components.code,{children:`/etc/ssl/private`}),` respectively.`]}),`\n`,_jsxs(_components.p,{children:[`You can then run `,_jsx(_components.code,{children:`nginx -t`}),` to verify your configuration is correct, and `,_jsx(_components.code,{children:`systemctl reload nginx`}),` to reload and apply the certificate.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`We strongly advise you use Lets Encrypt with Cito for automatic certificate renewal and management. You cannot use Aliases with a custom SSL certificate.`})}),`\n`,_jsx(Heading,{level:`2`,id:`wildcard-certificates`,children:`Wildcard certificates`}),`\n`,_jsx(_components.p,{children:`Contact support if you wish to use a wildcard certificate with Cito- this requires a manual configuration change in Nginx and so must be done manually.`}),`\n`,_jsx(_components.p,{children:`We can help you issue a wildcard certificate and configure it on your chosen domain. We will provide a DNS TXT record which you can use to validate domain ownership.`})]})}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":"SSL Certificates","description":"Automatic Let's Encrypt SSL certificates and custom certificate options","href":"/cli/ssl"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Renewals","slug":"renewals","depth":2,"children":[]},{"title":"How certificates are shared","slug":"how-certificates-are-shared","depth":2,"children":[]},{"title":"Manually issuing a certificate","slug":"manually-issuing-a-certificate","depth":2,"children":[]},{"title":"Bringing your own certificate","slug":"bringing-your-own-certificate","depth":2,"children":[]},{"title":"Wildcard certificates","slug":"wildcard-certificates","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"localhost","siteName":"Prostack Cito","title":"SSL Certificates - Prostack Cito","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"cli/ssl.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=\"Automatic Let\u0026#x27;s Encrypt SSL certificates and custom certificate options\">\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=\"SSL Certificates - Prostack Cito\">\u003cmeta data-mint-head property=\"og:description\" content=\"Automatic Let\u0026#x27;s Encrypt SSL certificates and custom certificate options\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Prostack Cito\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://local./cli/ssl\">\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=\"SSL Certificates - Prostack Cito\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Automatic Let\u0026#x27;s Encrypt SSL certificates and custom certificate options\">\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./cli/ssl\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/cli/ssl.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":"/cli/ssl.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","href":"/getting-started/ssh-keys"},{"title":"Migrating from another host","href":"/getting-started/migration"},{"title":"Frequently Asked Questions","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","description":"Check the registrar, nameservers and DNS status of your domain","href":"/managing-sites/domain-information"},{"title":"SSL Certificates","href":"/cli/ssl"},{"title":"Email","description":"Outgoing email configuration, logs, DKIM, SPF, and DMARC","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":"SSL Certificates - Prostack Cito","buildId":"3fee6f877672","dynamics":[],"chunks":[]}