# Linkwarden Docker Hosting: Deploy & Host Linkwarden in One Click

> Deploy Linkwarden Docker hosting on xCloud with One Click Apps, Docker + NGINX, Demo Site or Go Live, PostgreSQL, archive storage, and backups.

# Linkwarden Docker Hosting: Deploy & Host Linkwarden in One Click

**Linkwarden Docker hosting on xCloud** lets you deploy the open-source bookmark manager from the xCloud app-create flow: **Sites → New Site → One Click Apps → Linkwarden → Docker + NGINX server → Demo Site or Go Live → Create**. You do not need to start with a custom `docker-compose.yml`; xCloud creates the app as a managed Docker site and keeps domain, SSL, logs, backups, and updates in the site dashboard.

![Linkwarden Docker hosting one-click app selected in the xCloud One Click Apps catalog](/_landing/docs/linkwarden-docker-hosting-one-click-xcloud-linkwarden-card.png)

Linkwarden Docker hosting one-click app selected in the xCloud One Click Apps catalog

## Table of contents

-   [Why use xCloud for Linkwarden hosting?](#why-use-xcloud-for-linkwarden-hosting)
-   [Requirements](#linkwarden-hosting-requirements)
-   [One-click deployment steps](#deploy-linkwarden-in-one-click-on-xcloud)
-   [Post-deployment setup](#post-deployment-linkwarden-setup)
-   [xCloud vs Railway vs Coolify](#xcloud-vs-railway-vs-coolify-for-linkwarden)
-   [Troubleshooting](#troubleshooting)

## Why use xCloud for Linkwarden hosting?

Linkwarden can become a long-running knowledge base, not just a small bookmark app. Saved pages, archived content, screenshots, search indexes, and team activity all affect storage and maintenance. xCloud keeps deployment short while still giving operators a dashboard for the site, server, domain, SSL, backups, logs, and updates.

<table><thead><tr><th>Need</th><th>How xCloud handles it</th></tr></thead><tbody><tr><td>Fast app start</td><td>Choose <strong>Linkwarden</strong> in One Click Apps and create the site from the dashboard.</td></tr><tr><td>Server choice</td><td>Deploy to an existing or xCloud-managed <strong>Docker + NGINX</strong> server.</td></tr><tr><td>No custom Compose authoring</td><td>The template drives the Docker setup through the xCloud create-site flow.</td></tr><tr><td>Safe review path</td><td>Use <strong>Demo Site</strong> before attaching a production domain.</td></tr><tr><td>Operations after launch</td><td>Manage domain, SSL, logs, backups, site settings, and updates from xCloud.</td></tr></tbody></table>

## Linkwarden hosting requirements

<table><thead><tr><th>Requirement</th><th>Recommendation</th><th>Why it matters</th></tr></thead><tbody><tr><td>Server stack</td><td>Docker + NGINX</td><td>This xCloud flow deploys Linkwarden as a Docker-based app.</td></tr><tr><td>Database</td><td>PostgreSQL-backed app data</td><td>Linkwarden stores users, collections, links, metadata, and app state in the database.</td></tr><tr><td>Storage</td><td>Plan for archive growth</td><td>Preserved pages, screenshots, uploaded files, and indexes can grow over time.</td></tr><tr><td>Domain and SSL</td><td>Use Go Live for production</td><td>Secure login sessions and team access require HTTPS.</td></tr><tr><td>Email/SMTP</td><td>Configure for team workspaces</td><td>Invites and password reset flows need working email.</td></tr><tr><td>Resources</td><td>Increase memory/storage for heavy archiving</td><td>Search and archive workloads need more headroom than a small personal link list.</td></tr></tbody></table>

## Linkwarden template components

<table><thead><tr><th>Component</th><th>Purpose</th><th>Operational note</th></tr></thead><tbody><tr><td>Linkwarden application service</td><td>Runs the web app and API.</td><td>Verify login, collections, save flow, and archive flow after deployment.</td></tr><tr><td>PostgreSQL database</td><td>Stores users, collections, links, metadata, and settings.</td><td>Back it up before updates or migration.</td></tr><tr><td>Search/indexing service</td><td>Supports fast lookup across saved links and preserved content.</td><td>Give it enough memory for larger teams.</td></tr><tr><td>Archive/persistent storage</td><td>Stores preserved pages, screenshots, and uploaded content.</td><td>Monitor disk growth and include it in backups.</td></tr><tr><td>NGINX routing and SSL</td><td>Routes and secures the Demo Site or custom domain.</td><td>Use Go Live for production team access.</td></tr></tbody></table>

## Deploy Linkwarden in one click on xCloud

### 1\. Open New Site

In xCloud, go to **Sites** and click **New Site**. Select the Docker + NGINX server that should host Linkwarden.

**Expected result:** xCloud opens the create-site screen for the selected server.

### 2\. Choose One Click Apps

Select **One Click Apps** to open the app catalog instead of a Git deployment or manual upload flow.

**Expected result:** You can search and select one-click app templates.

### 3\. Select Linkwarden

Search for **Linkwarden** or browse the Productivity category, then select the Linkwarden app card.

**Expected result:** xCloud opens the Linkwarden app-create screen for the selected Docker + NGINX server.

### 4\. Add site details

Enter a clear **Site Title**, such as `Linkwarden`, `Research Bookmarks`, or `Team Bookmarks`. Add tags if your team uses them.

**Expected result:** xCloud prepares the site identity and applies the Linkwarden template.

### 5\. Choose Demo Site or Go Live

Choose **Demo Site** for a temporary review URL, or choose **Go Live** when the production domain is ready.

**Expected result:** xCloud knows whether to create a temporary demo URL or attach your own domain.

### 6\. Review generated settings and click Create

Review generated app URL, credentials, database settings, secret values, and template options. Store generated credentials in a secure password manager, then click **Create**.

**Expected result:** xCloud provisions the Linkwarden Docker site and opens deployment progress or the site dashboard when ready.

## Post-deployment Linkwarden setup

<table><thead><tr><th>Setup area</th><th>What to do</th><th>Success check</th></tr></thead><tbody><tr><td>Domain and SSL</td><td>Open the Linkwarden URL and confirm HTTPS.</td><td>The app loads without certificate warnings.</td></tr><tr><td>First user</td><td>Create the first admin/user account and save credentials securely.</td><td>You can log in and access the dashboard.</td></tr><tr><td>Registration</td><td>Disable open registration unless the workspace should be public.</td><td>Unknown users cannot self-register.</td></tr><tr><td>SMTP</td><td>Configure email for invites and password reset.</td><td>A test invite or reset email is delivered.</td></tr><tr><td>Save flow</td><td>Save a public test bookmark into a collection.</td><td>The bookmark appears with title and metadata.</td></tr><tr><td>Archive flow</td><td>Preserve a public page and wait for processing.</td><td>The archived page or screenshot is available.</td></tr><tr><td>Search flow</td><td>Search for the saved bookmark after indexing.</td><td>The bookmark appears in search results.</td></tr><tr><td>Backups</td><td>Back up database and persistent archive storage.</td><td>A recent backup exists before real team use.</td></tr></tbody></table>

## Resource and storage planning

<table><thead><tr><th>Workload</th><th>What grows</th><th>Planning note</th></tr></thead><tbody><tr><td>Personal bookmarks</td><td>Small database and low archive storage.</td><td>A small Docker + NGINX server is usually enough to start.</td></tr><tr><td>Team knowledge base</td><td>More users, collections, links, and metadata.</td><td>Monitor database size and query performance.</td></tr><tr><td>Heavy page archiving</td><td>Screenshots, HTML snapshots, uploads, and preserved content.</td><td>Plan extra disk and backup retention.</td></tr><tr><td>Search-heavy workspace</td><td>Indexes and search service memory.</td><td>Increase memory before search becomes slow.</td></tr></tbody></table>

## xCloud vs Railway vs Coolify for Linkwarden

<table><thead><tr><th>Platform</th><th>Best for</th><th>Deployment model</th><th>Operational tradeoff</th></tr></thead><tbody><tr><td>xCloud</td><td>Teams that want one-click app creation plus server/site operations in one dashboard.</td><td>New Site → One Click Apps → Linkwarden → Docker + NGINX server → Demo Site/Go Live → Create.</td><td>You manage the app as an xCloud site with domain, SSL, logs, backups, and updates.</td></tr><tr><td>Railway</td><td>Users already deploying services on Railway and comfortable with Railway projects.</td><td>Template-style deployment on Railway infrastructure.</td><td>Review runtime/storage settings for archive-heavy bookmark workloads.</td></tr><tr><td>Coolify</td><td>Users who want to self-host their own PaaS layer.</td><td>Service/app deployment inside a Coolify instance.</td><td>You also maintain the Coolify host, platform updates, and backups.</td></tr></tbody></table>

## Troubleshooting

<table><thead><tr><th>Symptom</th><th>Likely cause</th><th>Fix</th></tr></thead><tbody><tr><td>Linkwarden page does not load</td><td>Deployment unfinished, container stopped, or domain not routed.</td><td>Check deployment progress, container health, and domain routing in xCloud.</td></tr><tr><td>Login or invite email fails</td><td>SMTP is missing or credentials are rejected.</td><td>Verify SMTP settings and sender authentication.</td></tr><tr><td>Saved page is not archived</td><td>Archive worker/service is still processing or unhealthy.</td><td>Check app services and retry with a public URL.</td></tr><tr><td>Search does not show a new link</td><td>Indexing is delayed or search service needs attention.</td><td>Wait for indexing, then check search/index health.</td></tr><tr><td>Disk usage grows quickly</td><td>Archive storage, screenshots, uploads, and indexes are expanding.</td><td>Review retention, increase storage, and confirm backups.</td></tr></tbody></table>

## FAQ

### Can I deploy Linkwarden without writing Docker Compose?

Yes. In xCloud, choose Linkwarden from One Click Apps and create the site on a Docker + NGINX server.

### What should I test before inviting a team?

Verify HTTPS, login, invite email, saving a bookmark, archiving a page, search, and backup coverage.

### Why does Linkwarden need storage planning?

Bookmarks are small, but archived pages, screenshots, uploads, and search indexes can grow as the workspace saves more content.

## Related resources

-   [xCloud Docker hosting](https://xcloud.host/docker-hosting/)
-   [xCloud managed hosting](https://xcloud.host/managed-hosting/)
-   [xCloud One Click Apps](https://xcloud.host/one-click-apps/)
-   [Linkwarden website](https://linkwarden.app/)
-   [Linkwarden GitHub repository](https://github.com/linkwarden/linkwarden)
-   [Linkwarden documentation](https://docs.linkwarden.app/)