{"result":{"depiction_url":null,"edges":{"hasreference":{"objects":[{"created":"2026-10-07T11:13:45Z","object_id":{"id":3066,"is_a":["text","documentation","adminguide"],"name":"admin_hostnames_https","title":{"_type":"trans","tr":{"en":"Configure hostnames and HTTPS"}},"uri":"https:\/\/zotonic.com\/id\/3066"},"seq":1}],"predicate":{"id":2774,"is_a":["meta","predicate"],"name":"hasreference","title":{"_type":"trans","tr":{"en":"Documentation reference"}},"uri":"https:\/\/zotonic.com\/id\/hasreference"}},"references":{"objects":[{"created":"2020-05-30T05:47:36Z","object_id":{"id":1789,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_deployment_privilegedports","title":{"_type":"trans","tr":{"en":"Serve HTTPS on a privileged port"}},"uri":"https:\/\/zotonic.com\/id\/1789"},"seq":1000000},{"created":"2020-05-30T05:47:36Z","object_id":{"id":1482,"is_a":["text","documentation","reference"],"name":"doc_developerguide_configuration_port_ssl_configuration","title":"Port configurations","uri":"https:\/\/zotonic.com\/id\/1482"},"seq":1000000},{"created":"2020-05-30T05:47:36Z","object_id":{"id":1790,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_deployment_nginx","title":{"_type":"trans","tr":{"en":"Put Zotonic behind nginx"}},"uri":"https:\/\/zotonic.com\/id\/1790"},"seq":1000000},{"created":"2020-05-30T05:47:36Z","object_id":{"id":1754,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_ssl_letsencrypt","title":"mod_ssl_letsencrypt","uri":"https:\/\/zotonic.com\/id\/1754"},"seq":1000000},{"created":"2020-05-30T05:47:36Z","object_id":{"id":1753,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_ssl_ca","title":"mod_ssl_ca","uri":"https:\/\/zotonic.com\/id\/1753"},"seq":1000000}],"predicate":{"id":332,"is_a":["meta","predicate"],"name":"references","title":{"_type":"trans","tr":{"en":"References"}},"uri":"https:\/\/zotonic.com\/id\/references"}},"subject":{"objects":[{"created":"2026-10-07T11:13:45Z","object_id":{"id":2554,"is_a":["categorization","keyword","keyword_information_type"],"name":"zotonic_topic_how_to_guide","title":"How-to guide","uri":"https:\/\/zotonic.com\/id\/2554"},"seq":1},{"created":"2026-10-07T11:13:45Z","object_id":{"id":2566,"is_a":["categorization","keyword","keyword_audience"],"name":"zotonic_topic_operator","title":"Operator","uri":"https:\/\/zotonic.com\/id\/2566"},"seq":2},{"created":"2026-10-07T11:13:45Z","object_id":{"id":2682,"is_a":["categorization","keyword","keyword_technology"],"name":"zotonic_topic_tls_and_certificates","title":"TLS and certificates","uri":"https:\/\/zotonic.com\/id\/2682"},"seq":3},{"created":"2026-10-07T11:13:45Z","object_id":{"id":2685,"is_a":["categorization","keyword","keyword_quality"],"name":"zotonic_topic_security","title":"Security","uri":"https:\/\/zotonic.com\/id\/2685"},"seq":4},{"created":"2026-10-07T11:13:45Z","object_id":{"id":2603,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_configuration","title":"Configuration","uri":"https:\/\/zotonic.com\/id\/2603"},"seq":5}],"predicate":{"id":308,"is_a":["meta","predicate"],"name":"subject","title":{"_type":"trans","tr":{"en":"Keyword"}},"uri":"http:\/\/purl.org\/dc\/elements\/1.1\/subject"}}},"id":1755,"is_a":["text","documentation","developerguide"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1755"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"doc_developerguide_deployment_https","page_url":{"en":"https:\/\/zotonic.com\/docs\/1755\/configure-hostnames-and-https","x-default":"https:\/\/zotonic.com\/docs\/1755\/configure-hostnames-and-https"},"preview_url":null,"resource":{"body":{"_type":"trans","tr":{"en":"<p><strong>Access needed:<\/strong> DNS and server configuration access.<\/p>\n<ol><li>Decide the canonical hostname and required aliases. Make DNS point to the intended server or reverse proxy.<\/li><li>Set the matching site hostname and aliases, and check the externally visible HTTP\/HTTPS ports.<\/li><li>Choose where TLS terminates: Zotonic or a reverse proxy. Install certificates through that component&#39;s supported mechanism.<\/li><li>If using a proxy, forward the expected host and protocol information and support WebSocket connections. Keep direct backend access consistent with the deployment&#39;s access policy.<\/li><li>Test the canonical URL and each alias, redirects, certificate hostname and chain, admin login, and a live browser interaction.<\/li><li>Check certificate renewal and monitor expiry before it becomes an outage.<\/li><\/ol>\n<p>A working DNS record does not select the correct Zotonic site unless the hostname matches its configuration. A certificate working in your own browser is not proof that public clients trust it.<\/p>\n<p>For a local first run, use the developer setup instructions. Production certificates, public redirects, and proxy settings need the actual deployment&#39;s reviewed configuration.<\/p>"}},"category_id":{"id":317,"is_a":["meta","category"],"name":"developerguide","title":"Developer guide","uri":"https:\/\/zotonic.com\/id\/developerguide"},"content_group_id":{"id":339,"is_a":["meta","content_group"],"name":"default_content_group","title":{"_type":"trans","tr":{"en":"Default Content Group"}},"uri":"https:\/\/zotonic.com\/id\/default_content_group"},"created":"2020-05-30T05:47:33Z","creator_id":{"id":336,"is_a":["person","robot"],"name":"gitbot","title":"Git","uri":"https:\/\/zotonic.com\/id\/336"},"doc_editorial_bundle":true,"doc_editorial_edges":{"hasreference":[3066],"subject":[2554,2566,2603,2682,2685]},"github_url":"https:\/\/github.com\/zotonic\/zotonic\/tree\/master\/doc\/developer-guide\/deployment\/https.rst","is_authoritative":true,"is_dependent":false,"is_featured":false,"is_protected":false,"is_published":true,"is_unfindable":false,"language":["en"],"modified":"2026-10-07T11:13:56Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"name":"doc_developerguide_deployment_https","pivot_geocode":null,"pivot_location_lat":null,"pivot_location_lng":null,"privacy":0,"publication_end":"9999-06-01T00:00:00Z","publication_start":"2022-02-15T10:01:37Z","slug":"configure-hostnames-and-https","summary":{"_type":"trans","tr":{"en":"Align DNS, site selection, and certificate termination."}},"title":{"_type":"trans","tr":{"en":"Configure hostnames and HTTPS"}},"title_slug":{"_type":"trans","tr":{"en":"configure-hostnames-and-https"}},"tz":"UTC","uri":null,"version":33,"visible_for":0},"uri":"https:\/\/zotonic.com\/id\/1755","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1755"}},"status":"ok"}