move templating doc

Author: terion-labs

docs/.vitepress/config.mts

@@ -42,6 +42,7 @@ export default defineConfig({
           { text: "Overview", link: "/getting-started/" },
           { text: "Installation", link: "/getting-started/installation" },
           { text: "Creating Your First Instance", link: "/getting-started/creating-first-instance" },
+          { text: "Templating Containers with trm launch", link: "/getting-started/templating" },
           { text: "Storage and Sizing", link: "/getting-started/storage" },
           { text: "Domains and Authentication", link: "/getting-started/domains-and-auth" },
           { text: "Management GUIs", link: "/getting-started/management-guis" },
@@ -73,7 +74,6 @@ export default defineConfig({
           { text: "OpenClaw", link: "/guides/openclaw" },
           { text: "Hermes", link: "/guides/hermes" },
           { text: "VSCodium Web IDE", link: "/guides/vscode" },
-          { text: "Templating Containers with trm launch", link: "/guides/templating" },
           { text: "Isolated Docker Compose deployments", link: "/guides/compose" },
           { text: "Dokploy", link: "/guides/dokploy" },
           { text: "Coolify", link: "/guides/coolify" },

docs/getting-started/README.md

@@ -6,6 +6,7 @@ This section covers everything you need to know to get up and running:
 
 - **[Installation](installation.md):** The step-by-step process for getting Terrarium onto your VPS.
 - **[Creating Your First Instance](creating-first-instance.md):** How to spin up your first container and publish an app to the web.
+- **[Templating Containers with `trm launch`](templating.md):** How to turn repeatable app setup into one launch command with Ansible, Docker Compose, variables, and proxy labels.
 - **[Storage and Sizing](storage.md):** How to choose the right hardware and structure your storage for the best performance and snapshot capabilities.
 - **[Domains and Authentication](domains-and-auth.md):** Setting up custom domains and choosing how you want to handle Single Sign-On (SSO) for your private apps.
 - **[Management GUIs](management-guis.md):** A quick tour of the built-in visual dashboards you get right out of the box.

docs/getting-started/index.md

@@ -6,6 +6,7 @@ This section covers everything you need to know to get up and running:
 
 - **[Installation](./installation):** The step-by-step process for getting Terrarium onto your VPS.
 - **[Creating Your First Instance](./creating-first-instance):** How to spin up your first container and publish an app to the web.
+- **[Templating Containers with `trm launch`](./templating):** How to turn repeatable app setup into one launch command with Ansible, Docker Compose, variables, and proxy labels.
 - **[Storage and Sizing](./storage):** How to choose the right hardware and structure your storage for the best performance and snapshot capabilities.
 - **[Domains and Authentication](./domains-and-auth):** Setting up custom domains and choosing how you want to handle Single Sign-On (SSO) for your private apps.
 - **[Management GUIs](./management-guis):** A quick tour of the built-in visual dashboards you get right out of the box.

docs/guides/templating.md docs/getting-started/templating.mddocs/guides/templating.md renamed to docs/getting-started/templating.md

@@ -289,4 +289,4 @@ If the app is running but the public route does not respond, check that the serv
 terrariumctl proxy sync
 ```
 
-For the full route label grammar, including authenticated routes and wildcard domains, see [Domains and Authentication](../getting-started/domains-and-auth.md#published-app-route-labels).
+For the full route label grammar, including authenticated routes and wildcard domains, see [Domains and Authentication](domains-and-auth.md#published-app-route-labels).

docs/guides/README.md

@@ -19,7 +19,6 @@ You can run databases, internal APIs, and experimental AI agents without worryin
 - **[VSCodium Web IDE](vscode.md):** The absolute best way to code in the cloud. Spin up a browser-based editor that is completely isolated and secured by SSO.
 - **[OpenClaw](openclaw.md):** Give the powerful autonomous AI agent a safe, disposable sandbox to execute code in.
 - **[Hermes](hermes.md):** Run agent-driven background services and expose only the user interface to the web.
-- **[Templating Containers with `trm launch`](templating.md):** Use Ansible, Galaxy roles, Docker Compose, variables, and proxy labels to launch ready-to-use containers in one command.
 - **[Docker Compose Stacks](compose.md):** The cleanest way to run multi-container apps (like a web server + Postgres + Redis) without making a mess of your host machine.
 - **[Dokploy](dokploy.md):** Turn your Terrarium containers into an automated, UI-driven deployment platform (like Heroku or Vercel).
 - **[Coolify](coolify.md):** Another excellent, self-hosted Heroku alternative that runs perfectly inside a single Terrarium LXC.

docs/guides/index.md

@@ -19,7 +19,6 @@ You can run databases, internal APIs, and experimental AI agents without worryin
 - **[VSCodium Web IDE](vscode.md):** The absolute best way to code in the cloud. Spin up a browser-based editor that is completely isolated and secured by SSO.
 - **[OpenClaw](openclaw.md):** Give the powerful autonomous AI agent a safe, disposable sandbox to execute code in.
 - **[Hermes](hermes.md):** Run agent-driven background services and expose only the user interface to the web.
-- **[Templating Containers with `trm launch`](templating.md):** Use Ansible, Galaxy roles, Docker Compose, variables, and proxy labels to launch ready-to-use containers in one command.
 - **[Docker Compose Stacks](compose.md):** The cleanest way to run multi-container apps (like a web server + Postgres + Redis) without making a mess of your host machine.
 - **[Dokploy](dokploy.md):** Turn your Terrarium containers into an automated, UI-driven deployment platform (like Heroku or Vercel).
 - **[Coolify](coolify.md):** Another excellent, self-hosted Heroku alternative that runs perfectly inside a single Terrarium LXC.

docs/reference/terrariumctl.md

@@ -53,7 +53,7 @@ trm launch ubuntu:24.04 web-01 --profile dev
 trm launch ubuntu:24.04 web-01 --disk 40G --memory 4G --cpu 2
 ```
 
-For a more practical walkthrough with Ansible, Docker Compose, variables, Git assets, and proxy labels, see [Templating Containers with `trm launch`](../guides/templating.md).
+For a more practical walkthrough with Ansible, Docker Compose, variables, Git assets, and proxy labels, see [Templating Containers with `trm launch`](../getting-started/templating.md).
 
 Provisioning flags generate cloud-init user-data that installs the needed packages and runs inside the new container:
 

tests/docs-config.test.ts

@@ -21,7 +21,7 @@ describe("docs config", () => {
     const docsConfig = readRepoFile("docs/.vitepress/config.mts");
     const reference = readRepoFile("docs/reference/terrariumctl.md");
     const firstInstance = readRepoFile("docs/getting-started/creating-first-instance.md");
-    const templating = readRepoFile("docs/guides/templating.md");
+    const templating = readRepoFile("docs/getting-started/templating.md");
     const guidePaths = [
       "docs/guides/openclaw.md",
       "docs/guides/hermes.md",
@@ -41,7 +41,7 @@ describe("docs config", () => {
     expect(reference).toContain("| `terrariumctl launch` |");
     expect(reference).toContain("trm launch ubuntu:24.04 app-01 --docker-compose ./docker-compose.yml");
     expect(reference).toContain("Templating Containers with `trm launch`");
-    expect(docsConfig).toContain('link: "/guides/templating"');
+    expect(docsConfig).toContain('link: "/getting-started/templating"');
     expect(templating).toContain("trm launch ubuntu:24.04 customer-portal");
     expect(templating).toContain("--vars ./portal.env");
     expect(templating).toContain("--var APP_ENV=production");