Update markdoc.config.mjs

markdoc.config.mjs

@@ -28,6 +28,9 @@ export default defineMarkdocConfig({
 		},
 		configOptions: {
 			render: component('./src/components/partials/ConfigOptions.astro'),
+		},
+		cloudHostingAffiliate: {
+			render: component('./src/components/partials/CloudHostingAffiliate.astro'),
 		}
 	},
 	nodes: {

src/components/partials/CloudHostingAffiliate.astro

@@ -0,0 +1,24 @@
+<div class="border border-primary px-6 rounded">
+    <h2 id="getting-a-server-to-host-vikunja-on" class="mt-6">
+        Getting a server to host Vikunja on
+    </h2>
+
+    <p>
+        If you want the easy experience of just using Vikunja, we reccomend our own hosted offering <a href="https://app.vikunja.cloud/?redirectToProvider=true">Vikunja Cloud</a>.
+        With Vikunja Cloud, we take care of everything and make it very easy for you, to sign up and use it, hassle-free.
+    </p>
+
+    <p>
+        If you want more control, you need to install and run Vikunja on a server.
+        Since it's designed as a web application, it is not really possible to host it standalone on a desktop device only. If you know what you're doing, you can get it working but that's out of scope for this guide.
+    </p>
+
+    <p>To get a server, we reccomend one of these hosting providers (affiliate links):</p>
+    <ul>
+        <li><a href="https://hetzner.cloud/?ref=rftnSU8lrkmT">Hetzner</a> - German provider, we're using them to host a bunch of Vikunja-related infrastructure. Sign up with <a href="https://hetzner.cloud/?ref=rftnSU8lrkmT">our link</a> to get 20 € in hosting credits.</li>
+        <li><a href="https://m.do.co/c/2d0f6efa8d5c">Digital Ocean</a> - Well known cloud provider with a lot of options to choose from. Sign up with <a href="https://m.do.co/c/2d0f6efa8d5c">our link</a> to get $ 200 USD in hosting credits.</li>
+    </ul>
+
+    <p>All of these are affiliate links. If you sign up for one of these providers, we get a comission which helps support the project.</p>
+
+</div>

src/content/docs/setup/docker-start-to-finish.mdoc

@@ -13,6 +13,9 @@ We'll use [docker compose](https://docs.docker.com/compose/) to make handling th
 
 > If you have any issues setting up Vikunja, please don't hesitate to reach out to us via [matrix](https://riot.im/app/#/room/!dCRiCiLaCCFVNlDnYs:matrix.org?via=matrix.org), the [community forum](https://community.vikunja.io/) or even [email](mailto:hello@vikunja.io).
 
+{% cloudHostingAffiliate %}
+{% /cloudHostingAffiliate %}
+
 ## Preparations (optional)
 
 Create a directory for the project where all data and the compose file will live in.
@@ -46,7 +49,7 @@ services:
         environment:
             POSTGRES_PASSWORD: changeme
             POSTGRES_USER: vikunja
-            
+
         volumes:
             - ./db:/var/lib/postgresql/data
         restart: unless-stopped

src/content/docs/setup/install.mdoc

@@ -44,6 +44,9 @@ And after you installed Vikunja, you may want to check out these other resources
 * [Harden systemd service](/docs/systemd-hardening)
 * [Fail2Ban](/docs/fail2ban)
 
+{% cloudHostingAffiliate %}
+{% /cloudHostingAffiliate %}
+
 ## Install from binary
 
 Download a copy of Vikunja from the [download page](https://dl.vikunja.io/vikunja/) for your architecture.
@@ -206,7 +209,7 @@ To configure Vikunja, use the config file in `/etc/vikunja/config.yml`.
 
 ## FreeBSD / FreeNAS
 
-Unfortunately, we currently can't provide pre-built binaries for FreeBSD. As a workaround, it is possible to compile 
+Unfortunately, we currently can't provide pre-built binaries for FreeBSD. As a workaround, it is possible to compile
 Vikunja for FreeBSD directly on a FreeBSD machine, a guide is available below:
 
 *Thanks to HungrySkeleton who originally created this