msgid "ServNest is software providing an HTTP service with HTML interface allowing users to manage 3 independent services:\n"
msgstr ""
#. type: Plain text
#: index.en.md:8
#, markdown-text, no-wrap
msgid "* Subdomain registration and delegation, in a public suffix registry\n* DNS zone hosting\n* Static HTTP site hosting (installed using SFTP)\n"
msgstr ""
#. type: Title ##
#: index.en.md:9
#, markdown-text, no-wrap
msgid "Documentation"
msgstr ""
#. type: Plain text
#: index.en.md:13
#, markdown-text, no-wrap
msgid "[User documentation](front/)\n: use an existing ServNest installation\n"
msgstr ""
#. type: Plain text
#: index.en.md:16
#, markdown-text, no-wrap
msgid "[Internals](back/)\n: understand, contribute or deploy a new ServNest installation\n"
msgstr ""
#. type: Title ##
#: index.en.md:17
#, markdown-text, no-wrap
msgid "Status"
msgstr ""
#. type: Plain text
#: index.en.md:20
#, markdown-text, no-wrap
msgid "ServNest is alpha software. Proper versioning, changelog and upgrade and migration instructions are still missing.\n"
msgstr ""
#. type: Title ##
#: index.en.md:21
#, markdown-text, no-wrap
msgid "Installation list"
msgstr ""
#. type: Plain text
#: index.en.md:25
#, markdown-text, no-wrap
msgid "[Niver](https://about.niv.re/)\n: administrated by the main developer\n"
msgstr ""
#. type: Title ##
#: index.en.md:26
#, markdown-text, no-wrap
msgid "Detailed features"
msgstr ""
#. type: Title ###
#: index.en.md:28
#, markdown-text, no-wrap
msgid "Public suffix registry (`reg`)"
msgstr ""
#. type: Plain text
#: index.en.md:37
#, markdown-text, no-wrap
msgid "* Register a subdomain of the registry\n* Set domain's nameservers\n* Set a DS record to enable DNSSEC\n* Set Glue records\n* Display records\n* Transfer domain to another account\n* Partial `CSYNC` and `CDS` support to synchronize from child zone\n"
msgstr ""
#. type: Title ###
#: index.en.md:38
#, markdown-text, no-wrap
msgid "Name server (`ns`)"
msgstr ""
#. type: Plain text
#: index.en.md:45
#, markdown-text, no-wrap
msgid "* Host a zone on the server\n* Plain zone file edition\n* Dedicated forms to set/unset `A`, `AAAA`, `NS`, `TXT`, `CAA`, `SRV`, `MX`, `SRV`, `SSHFP`, `TLSA`, `CNAME`, `DNAME` and `LOC` records\n* Display records or the full zone file\n* Keep records in sync with another domain (`CNAME` alternative for apex domains)\n"
msgstr ""
#. type: Title ###
#: index.en.md:46
#, markdown-text, no-wrap
msgid "Static HTTP site hosting (`ht`)"
msgstr ""
#. type: Plain text
#: index.en.md:49
#, markdown-text, no-wrap
msgid "Upload site's files to the server using SFTP. The way the site is accessed can then be choosed:\n"
msgstr ""
#. type: Plain text
#: index.en.md:54
#, markdown-text, no-wrap
msgid "* Dedicated domain name and Let's Encrypt certificate\n* Dedicated onion service (through Tor)\n* Subdomain of a shared root domain\n* HTTP subpath of a shared domain\n"
msgstr ""
#. type: Plain text
#: index.en.md:56
#, markdown-text, no-wrap
msgid "Some Apache configuration directives are available through `.htaccess`.\n"
msgid "[Matrix room](matrix:r/servnest:matrix.antopie.org) (`#servnest:matrix.antopie.org`)\n: english/french\n: discuss, get help and organise contribution\n"
msgid "Code, configuration and documentation are published under the Cooperative Nonviolent Public License No Attributions, version 7 or any later version (<abbr>CNPL-NAv7+</abbr>). See the [Nonviolent Public Licenses](https://thufie.lain.haus/NPL.html).\n"
msgid "* [Use ServNest](full-howto)\n* [How to create a static site](site-creation)\n"
msgstr ""
#. type: Title #
#: front/full-howto.en.md:1
#, markdown-text, no-wrap
msgid "Use ServNest"
msgstr ""
#. type: Title ##
#: front/full-howto.en.md:3
#, markdown-text, no-wrap
msgid "Introduction"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:6
#, markdown-text, no-wrap
msgid "This document describes the steps for the combined use of each service of a ServNest installation.\n"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:12
#, markdown-text, no-wrap
msgid "In short, it consists of:\n1. on the **Authentication** service: creating an account\n2. on the **Registry** service: registering a domain name in one of the available suffixes\n3. on the **Name servers** service: configuring a DNS zone for this domain\n4. on the **Web** service: uploading files using SFTP and making them accessible through the Web with the domain previously registered and configured\n"
msgstr ""
#. type: Title ##
#: front/full-howto.en.md:13
#, markdown-text, no-wrap
msgid "Prerequisites"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:20
#, markdown-text, no-wrap
msgid "* the address of an existing ServNest installation (see the list on the homepage)\n* a way to communicate with the chosen installation administrator, to get the account approved\n* a web browser (for example LibreWolf, Tor Browser or Firefox)\n* an SFTP client (for example Dolphin on KDE, GNOME Files or FileZilla)\n* files to be served on the site (typically in HTML format)\n"
msgstr ""
#. type: Title ##
#: front/full-howto.en.md:21
#, markdown-text, no-wrap
msgid "Step 1: account creation"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:24
#, markdown-text, no-wrap
msgid "Create an account and get it approved\n"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:28
#, markdown-text, no-wrap
msgid "1. From the chosen ServNest installation home page, go to the **Authentication** service, then use the page **Create account**\n2. Ask your installation administrator an approval key, according to the instructions on the link **About this installation** on the installation home page, and wait for their answer\n3. Use the answered key on the **Switch to an approved account** page\n"
msgstr ""
#. type: Title ##
#: front/full-howto.en.md:29
#, markdown-text, no-wrap
msgid "Step 2: domain registration"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:32
#, markdown-text, no-wrap
msgid "Choose a domain name\n"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:35
#, markdown-text, no-wrap
msgid "1. Go to the **Registry** service\n2. **Register domain**\n"
msgstr ""
#. type: Title ##
#: front/full-howto.en.md:36
#, markdown-text, no-wrap
msgid "Step 3: the DNS zone"
msgstr ""
#. type: Title ###
#: front/full-howto.en.md:38
#, markdown-text, no-wrap
msgid "Step 3.1: DNS zone creation"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:41
#, markdown-text, no-wrap
msgid "Authenticate the DNS zone creation by creating a specific DNS record in the parent zone (the registry), then actually create the zone\n"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:46
#, markdown-text, no-wrap
msgid "1. On the **Name servers** > **Add zone** page, copy the required NS record value (Don't submit the form yet)\n2. Paste the value in **Registry** > **NS records** and submit\n3. Submit the form on **Name servers** > **Add zone**\n4. Paste the value in **Registry** > **NS records** again, but this time select the **Delete** action, then submit\n"
msgstr ""
#. type: Title ###
#: front/full-howto.en.md:47
#, markdown-text, no-wrap
msgid "Step 3.2: delegation to the DNS zone"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:50
#, markdown-text, no-wrap
msgid "Tell the registry to delegate the domain name resolution to the servers on which we just created the zone\n"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:53
#, markdown-text, no-wrap
msgid "For each domain name listed in the **Name servers** section on the home page of the **Name servers** service:\n1. Copy-paste this domain name in **Registry** > **DNS records** then submit\n"
msgstr ""
#. type: Title ###
#: front/full-howto.en.md:54
#, markdown-text, no-wrap
msgid "Optional step 3.3: DNSSEC activation"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:57
#, markdown-text, no-wrap
msgid "Tell the registry the public key of the DNS zone in order to enable the DNSSEC trust delegation and thus the DNS zone records authentication\n"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:60
#, markdown-text, no-wrap
msgid "1. On **Name servers** > **Display zone**, select **DS records** then submit\n2. Transmit the display values to **Registry** > **DS records**\n"
msgstr ""
#. type: Title ##
#: front/full-howto.en.md:61
#, markdown-text, no-wrap
msgid "Step 4: the website"
msgstr ""
#. type: Title ###
#: front/full-howto.en.md:63
#, markdown-text, no-wrap
msgid "Step 4.1: SFTP upload"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:69
#, markdown-text, no-wrap
msgid "1. Transmit the values displayed on the **Web** service home page to the SFTP client\n2. If the SFTP asks to confirm the server's public key fingerprint, check that it matches one of the values display on the web page. If none of the values match, cancel the connection, then check the settings, change Internet connection or contact the administrator. (Connecting to an SFTP server without verifying it's authenticity can allow an attacker to takeover your account.)\n3. The SFTP space is empty by default. Create a directory named without spaces, accents or special characters (for example `site`)\n4. Copy-paste the site files inside this new directory\n"
msgstr ""
#. type: Title ###
#: front/full-howto.en.md:70
#, markdown-text, no-wrap
msgid "Step 4.2: HTTP access creation"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:75
#, markdown-text, no-wrap
msgid "1. In **Name servers** > **Synchronized records**, add an entry with the domain displayed on **Web** > **Dedicated domain with Let's Encrypt certificate access** as the **Source domain**\n2. In **Name servers** > **TXT records**, add for the **Subdomain** `_auth` the value displayed on **Web** > **Dedicated domain with Let's Encrypt certificate access**\n3. Submit the form **Dedicated domain with Let's Encrypt certificate access**\n"
msgstr ""
#. type: Title ##
#: front/full-howto.en.md:76
#, markdown-text, no-wrap
msgid "Conclusion"
msgstr ""
#. type: Plain text
#: front/full-howto.en.md:78
#, markdown-text, no-wrap
msgid "Accessing `https://domain.example/file` displays the file `/site/file` from the SFTP space.\n"
msgstr ""
#. type: Title #
#: front/site-creation.en.md:1
#, markdown-text, no-wrap
msgid "How to create a static site"
msgstr ""
#. type: Title ##
#: front/site-creation.en.md:3
#, markdown-text, no-wrap
msgid "Manually"
msgstr ""
#. type: Plain text
#: front/site-creation.en.md:6
#, markdown-text, no-wrap
msgid "A site can be created by handwriting HTML files.\n"
msgstr ""
#. type: Title ##
#: front/site-creation.en.md:7
#, markdown-text, no-wrap
msgid "Using a static sites generator"
msgstr ""
#. type: Plain text
#: front/site-creation.en.md:10
#, markdown-text, no-wrap
msgid "Static sites generator are tools that generate static HTML sites from another format, usually from Markdown.\n"
msgstr ""
#. type: Plain text
#: front/site-creation.en.md:13
#, markdown-text, no-wrap
msgid "[Zola](https://www.getzola.org/)\n: command line interface\n"
msgstr ""
#. type: Plain text
#: front/site-creation.en.md:16
#, markdown-text, no-wrap
msgid "[Hugo](https://gohugo.io/)\n: command line interface\n"
msgstr ""
#. type: Plain text
#: front/site-creation.en.md:18
#, markdown-text, no-wrap
msgid "[Publii](https://getpublii.com/)\n: desktop software using Electron\n"