{"result":{"depiction_url":null,"edges":{"hasreference":{"objects":[{"created":"2026-10-07T11:13:49Z","object_id":{"id":2914,"is_a":["text","documentation","developerguide"],"name":"developer_create_site","title":{"_type":"trans","tr":{"en":"Create your first site"}},"uri":"https:\/\/zotonic.com\/id\/2914"},"seq":1},{"created":"2026-10-07T11:13:49Z","object_id":{"id":2923,"is_a":["text","documentation","developerguide"],"name":"developer_site_configuration","title":{"_type":"trans","tr":{"en":"Site configuration and enabled modules"}},"uri":"https:\/\/zotonic.com\/id\/2923"},"seq":2}],"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:48:15Z","object_id":{"id":1279,"is_a":["text","documentation"],"name":"doc_glossary","title":"Glossary","uri":"https:\/\/zotonic.com\/id\/1279"},"seq":1000000},{"created":"2020-05-30T05:48:15Z","object_id":{"id":1353,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_modules","title":{"_type":"trans","tr":{"en":"Create a reusable module"}},"uri":"https:\/\/zotonic.com\/id\/1353"},"seq":1000000},{"created":"2020-05-30T05:48:15Z","object_id":{"id":1352,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_templates","title":{"_type":"trans","tr":{"en":"Create a page layout"}},"uri":"https:\/\/zotonic.com\/id\/1352"},"seq":1000000},{"created":"2020-05-30T05:48:15Z","object_id":{"id":1541,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_dispatch_rules","title":{"_type":"trans","tr":{"en":"Follow a request to its template"}},"uri":"https:\/\/zotonic.com\/id\/1541"},"seq":1000000},{"created":"2020-05-30T05:48:15Z","object_id":{"id":1728,"is_a":["text","documentation","reference"],"name":"doc_developerguide_configuration_site_configuration","title":"Site configuration","uri":"https:\/\/zotonic.com\/id\/1728"},"seq":1000000},{"created":"2020-05-30T05:48:15Z","object_id":{"id":1529,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_troubleshooting","title":{"_type":"trans","tr":{"en":"A site does not start"}},"uri":"https:\/\/zotonic.com\/id\/1529"},"seq":1000000}],"predicate":{"id":332,"is_a":["meta","predicate"],"name":"references","title":{"_type":"trans","tr":{"en":"References"}},"uri":"https:\/\/zotonic.com\/id\/references"}},"refers":{"objects":[{"created":"2026-10-07T11:13:01Z","object_id":{"id":1526,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_getting_started","title":{"_type":"trans","tr":{"en":"Set up a local development environment"}},"uri":"https:\/\/zotonic.com\/id\/1526"},"seq":1000000},{"created":"2026-10-07T11:13:01Z","object_id":{"id":2915,"is_a":["text","documentation","developerguide"],"name":"developer_first_template_change","title":{"_type":"trans","tr":{"en":"Change a template and see the result"}},"uri":"https:\/\/zotonic.com\/id\/2915"},"seq":1000000},{"created":"2026-10-07T11:13:01Z","object_id":{"id":3005,"is_a":["text","documentation","developerguide"],"name":"developer_cmd_addsite","title":{"_type":"trans","tr":{"en":"addsite: Create a site application from a skeleton"}},"uri":"https:\/\/zotonic.com\/id\/3005"},"seq":1000000},{"created":"2026-10-07T11:13:01Z","object_id":{"id":3045,"is_a":["text","documentation","developerguide"],"name":"developer_local_postgresql","title":{"_type":"trans","tr":{"en":"Prepare local PostgreSQL"}},"uri":"https:\/\/zotonic.com\/id\/3045"},"seq":1000000}],"predicate":{"id":2409,"is_a":["meta","predicate"],"name":"refers","title":{"_type":"trans","tr":{"en":"Refers"}},"uri":"https:\/\/zotonic.com\/id\/refers"}},"relation":{"objects":[{"created":"2020-05-30T05:48:15Z","object_id":{"id":1529,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_troubleshooting","title":{"_type":"trans","tr":{"en":"A site does not start"}},"uri":"https:\/\/zotonic.com\/id\/1529"},"seq":1000000}],"predicate":{"id":303,"is_a":["meta","predicate"],"name":"relation","title":{"_type":"trans","tr":{"nl":"Relatie","en":"Relation"}},"uri":"http:\/\/purl.org\/dc\/terms\/relation"}},"subject":{"objects":[{"created":"2026-10-07T11:13:49Z","object_id":{"id":2553,"is_a":["categorization","keyword","keyword_information_type"],"name":"zotonic_topic_tutorial","title":"Tutorial","uri":"https:\/\/zotonic.com\/id\/2553"},"seq":1},{"created":"2026-10-07T11:13:49Z","object_id":{"id":2564,"is_a":["categorization","keyword","keyword_audience"],"name":"zotonic_topic_backend_developer","title":"Backend developer","uri":"https:\/\/zotonic.com\/id\/2564"},"seq":2},{"created":"2026-10-07T11:13:49Z","object_id":{"id":2634,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_site","title":"Site","uri":"https:\/\/zotonic.com\/id\/2634"},"seq":3},{"created":"2026-10-07T11:13:49Z","object_id":{"id":2605,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_site_management","title":"Site management","uri":"https:\/\/zotonic.com\/id\/2605"},"seq":4},{"created":"2026-10-07T11:13:49Z","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":1527,"is_a":["text","documentation","developerguide"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1527"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"doc_developerguide_sites","page_url":{"en":"https:\/\/zotonic.com\/docs\/1527\/create-your-first-site","x-default":"https:\/\/zotonic.com\/docs\/1527\/create-your-first-site"},"preview_url":null,"resource":{"body":{"_type":"trans","tr":{"en":"<p>Start with a running Zotonic node from <a href=\"\/id\/1526\">your installation route<\/a>. Run the commands below from the repository root, inside the container or Nix shell if you chose one.<\/p>\n<h2>1. Create the example site<\/h2>\n<pre class=\"notranslate\"><code class=\"notranslate language-sh\">bin\/zotonic addsite -s blog -H garden.test garden\nbin\/zotonic status\n<\/code><\/pre>\n<p>The command creates <code>apps_user\/garden<\/code>, prepares the database schema, compiles the application, and starts it on the running node. Expect <code>garden<\/code> to reach the running state. Keep the generated admin password shown in the output; you need it for the next step.<\/p>\n<h2>2. Give your browser the local hostname<\/h2>\n<p>On the computer running your browser, add this line to its hosts file using an administrator-enabled text editor:<\/p>\n<pre class=\"notranslate\"><code class=\"notranslate language-text\">127.0.0.1 garden.test\n<\/code><\/pre>\n<p>The file is <code>\/etc\/hosts<\/code> on macOS\/Linux and <code>C:\\Windows\\System32\\drivers\\etc\\hosts<\/code> on Windows. For containers, edit the computer&#39;s hosts file, not just the container&#39;s. Keep any existing entries. You can skip this step if your local DNS already resolves <code>garden.test<\/code> to this machine.<\/p>\n<h2>3. Open the site and admin<\/h2>\n<p>Open <a href=\"https:\/\/garden.test:8443\/\">your garden site<\/a> in the browser. These examples use the default development HTTPS port 8443; use your configured port if different. Expect the blog home page. The generated development certificate may need a local browser exception.<\/p>\n<p>Open <a href=\"https:\/\/garden.test:8443\/admin\">the garden admin<\/a> and log in as <strong>admin<\/strong>, using the password printed by <code>addsite<\/code>. These are your site&#39;s credentials, separate from the status site&#39;s <code>wwwadmin<\/code> account.<\/p>\n<h2>4. Make your first change<\/h2>\n<p>Open <code>apps_user\/garden<\/code> in your editor, then follow <a href=\"\/id\/2915\">Change a template and see the result<\/a>. There is no need to create a custom module first.<\/p>\n<p>If the wrong site opens, check the hosts entry and <code>priv\/zotonic_site.config<\/code> hostname. If creation fails, read the error and inspect the partially created directory before retrying. Native database problems can be checked with <a href=\"\/id\/3045\">Prepare local PostgreSQL<\/a>; containers use database host <code>postgres<\/code>. See <a href=\"\/id\/3005\">addsite options<\/a> for a non-default configuration.<\/p>\n<h2>Site configuration and enabled modules<\/h2>\n<p>A site is identified by its application and <code>priv\/zotonic_site<\/code> configuration. Supported formats include Erlang <code>.config<\/code>, JSON, and YAML; follow the format already used by the project.<\/p>\n<p>For Erlang configuration, the file is a list of terms ending with a period:<\/p>\n<pre class=\"notranslate\"><code class=\"notranslate language-erlang\">[\n    {enabled, true},\n    {environment, development},\n    {hostname, &quot;garden.test&quot;}\n].\n<\/code><\/pre>\n<p>This is a small fragment illustrating syntax, not a replacement for the generated database and module settings.<\/p>\n<p>Inspect the actual configuration sources with <code>siteconfigfiles garden<\/code> and <code>siteconfig garden<\/code>. A site&#39;s installation module list and its current activation state are different concerns, especially on database-backed sites. Verify enabled modules in the admin or module manager.<\/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:24Z","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":[2914,2923],"subject":[2553,2564,2603,2605,2634]},"github_url":"https:\/\/github.com\/zotonic\/zotonic\/tree\/master\/doc\/developer-guide\/sites.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:14:03Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"name":"doc_developerguide_sites","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:20Z","slug":"create-your-first-site","summary":{"_type":"trans","tr":{"en":"Create the garden blog, open it in your browser, and sign in to its admin."}},"title":{"_type":"trans","tr":{"en":"Create your first site"}},"title_slug":{"_type":"trans","tr":{"en":"create-your-first-site"}},"tz":"UTC","uri":null,"version":39,"visible_for":0},"uri":"https:\/\/zotonic.com\/id\/1527","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1527"}},"status":"ok"}