---
title: "Deploy Linkwarden | (Just Updated) Bookmark Manager and Link Archiver, Admin Login Generated, Sign-up Closed"
description: "Linkwarden bookmark manager and link archiver, Postgres, search, REST API"
category: "Storage"
url: https://railway.com/deploy/linkwarden-or-just-updated-bookmark-mana
---

# Deploy Linkwarden | (Just Updated) Bookmark Manager and Link Archiver, Admin Login Generated, Sign-up Closed

Linkwarden bookmark manager and link archiver, Postgres, search, REST API

**[Deploy Linkwarden | (Just Updated) Bookmark Manager and Link Archiver, Admin Login Generated, Sign-up Closed on Railway](https://railway.com/template/linkwarden-or-just-updated-bookmark-mana)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/linkwarden-or-just-updated-bookmark-mana/manifest.json

- **Creator:** SuperSlowSloth
- **Category:** Storage

## Template content

### postgres

- **Image:** postgres:17

### linkwarden

- **Image:** ghcr.io/linkwarden/linkwarden:v2.17.0@sha256:7c11fde57d1a0c819b6de0079966eba3a33584d718464af7dacde22bd470ae46
- **Start command:** `/bin/sh -c 'echo ZWNobyBMeThnUTNKbFlYUmxjeUIwYUdVZ1ptbHljM1FnVEdsdWEzZGhjbVJsYmlCaFkyTnZkVzUwSUNocFpDQXhMQ0IzYUdsamFDQjFjSE4wY21WaGJTQjBjbVZoZEhNZ1lYTWdkR2hsSUdsdWMzUmhibU5sSUdGa2JXbHVLU0JtY205dElFRkVUVWxPWDFCQlUxTlhUMUpFTENCdmJteDVDaTh2SUhkb1pXNGdkR2hsSUdSaGRHRmlZWE5sSUdodmJHUnpJRzV2SUhWelpYSWdZWFFnWVd4c0xpQkJJSEpsWkdWd2JHOTVJSFJvWlhKbFptOXlaU0J1WlhabGNpQnZkbVZ5ZDNKcGRHVnpJR0VnY0dGemMzZHZjbVFnWTJoaGJtZGxaQ0JwYmlCMGFHVWdWVWt1Q21OdmJuTjBJSHNnVUhKcGMyMWhRMnhwWlc1MElIMGdQU0J5WlhGMWFYSmxLQ0pBY0hKcGMyMWhMMk5zYVdWdWRDSXBPd3BqYjI1emRDQmlZM0o1Y0hRZ1BTQnlaWEYxYVhKbEtDSmlZM0o1Y0hRaUtUc0tDaWhoYzNsdVl5QW9LU0E5UGlCN0NpQWdZMjl1YzNRZ2NISnBjMjFoSUQwZ2JtVjNJRkJ5YVhOdFlVTnNhV1Z1ZENncE93b2dJR052Ym5OMElIQmhjM04zYjNKa0lEMGdjSEp2WTJWemN5NWxibll1UVVSTlNVNWZVRUZUVTFkUFVrUTdDaUFnYVdZZ0tDRndZWE56ZDI5eVpDQjhmQ0J3WVhOemQyOXlaQzVzWlc1bmRHZ2dQQ0E0S1NCMGFISnZkeUJ1WlhjZ1JYSnliM0lvSWtGRVRVbE9YMUJCVTFOWFQxSkVJRzFwYzNOcGJtY2diM0lnYzJodmNuUmxjaUIwYUdGdUlEZ2dZMmhoY21GamRHVnljeUlwT3dvZ0lHTnZibk4wSUhWelpYSnpJRDBnWVhkaGFYUWdjSEpwYzIxaExuVnpaWEl1WTI5MWJuUW9LVHNLSUNCcFppQW9kWE5sY25NZ1BpQXdLU0I3Q2lBZ0lDQmpiMjV6YjJ4bExteHZaeWdpYkdsdWEzZGhjbVJsYmkxaWIyOTBjM1J5WVhBNklDSWdLeUIxYzJWeWN5QXJJQ0lnZFhObGNpaHpLU0JoYkhKbFlXUjVJR1Y0YVhOMExDQmhaRzFwYmlCc1pXWjBJSFZ1ZEc5MVkyaGxaQ0lwT3dvZ0lIMGdaV3h6WlNCN0NpQWdJQ0JoZDJGcGRDQndjbWx6YldFdWRYTmxjaTVqY21WaGRHVW9ld29nSUNBZ0lDQmtZWFJoT2lCN0NpQWdJQ0FnSUNBZ2JtRnRaVG9nSWtGa2JXbHVJaXdLSUNBZ0lDQWdJQ0IxYzJWeWJtRnRaVG9nSW1Ga2JXbHVJaXdLSUNBZ0lDQWdJQ0JsYldGcGJGWmxjbWxtYVdWa09pQnVaWGNnUkdGMFpTZ3BMQW9nSUNBZ0lDQWdJSEJoYzNOM2IzSmtPaUJpWTNKNWNIUXVhR0Z6YUZONWJtTW9jR0Z6YzNkdmNtUXNJREV3S1N3S0lDQWdJQ0FnSUNCa1lYTm9ZbTloY21SVFpXTjBhVzl1Y3pvZ2V3b2dJQ0FnSUNBZ0lDQWdZM0psWVhSbFRXRnVlVG9nZXdvZ0lDQWdJQ0FnSUNBZ0lDQmtZWFJoT2lCYkNpQWdJQ0FnSUNBZ0lDQWdJQ0FnZXlCdmNtUmxjam9nTUN3Z2RIbHdaVG9nSWxOVVFWUlRJaUI5TEFvZ0lDQWdJQ0FnSUNBZ0lDQWdJSHNnYjNKa1pYSTZJREVzSUhSNWNHVTZJQ0pTUlVORlRsUmZURWxPUzFNaUlIMHNDaUFnSUNBZ0lDQWdJQ0FnSUNBZ2V5QnZjbVJsY2pvZ01pd2dkSGx3WlRvZ0lsQkpUazVGUkY5TVNVNUxVeUlnZlN3S0lDQWdJQ0FnSUNBZ0lDQWdYU3dLSUNBZ0lDQWdJQ0FnSUgwc0NpQWdJQ0FnSUNBZ2ZTd0tJQ0FnSUNBZ2ZTd0tJQ0FnSUgwcE93b2dJQ0FnWTI5dWMyOXNaUzVzYjJjb0lteHBibXQzWVhKa1pXNHRZbTl2ZEhOMGNtRndPaUJqY21WaGRHVmtJSFZ6WlhJZ1lXUnRhVzRnS0dsa0lERXBJR1p5YjIwZ1FVUk5TVTVmVUVGVFUxZFBVa1FpS1RzS0lDQjlDaUFnWVhkaGFYUWdjSEpwYzIxaExpUmthWE5qYjI1dVpXTjBLQ2s3Q24wcEtDa3VZMkYwWTJnb0tHVXBJRDArSUhzS0lDQmpiMjV6YjJ4bExtVnljbTl5S0NKc2FXNXJkMkZ5WkdWdUxXSnZiM1J6ZEhKaGNDQm1ZV2xzWldRNklDSWdLeUJsTG0xbGMzTmhaMlVwT3dvZ0lIQnliMk5sYzNNdVpYaHBkQ2d4S1RzS2ZTazdDZz09IHwgYmFzZTY0IC1kID4gL3RtcC9ib290c3RyYXAuanMKZWNobyBMeThnVUhKbGJHOWhaR1ZrSUhkcGRHZ2dUazlFUlY5UFVGUkpUMDVUUFMwdGNtVnhkV2x5WlM0Z1YybDBhQ0JPUlZoVVgxQlZRa3hKUTE5RVNWTkJRa3hGWDFKRlIwbFRWRkpCVkVsUFRqMTBjblZsSUV4cGJtdDNZWEprWlc0Z1lXNXpkMlZ5Y3lCaGJpQmhibTl1ZVcxdmRYTUtMeThnVUU5VFZDQXZZWEJwTDNZeEwzVnpaWEp6SUhkcGRHZ2dOREF3SUNKU1pXZHBjM1J5WVhScGIyNGdhWE1nWkdsellXSnNaV1F1SWlCVWFHRjBJR2x6SUdOdmNuSmxZM1FnWW5WMElISmxZV1J6SUd4cGEyVWdZU0J0WVd4bWIzSnRaV1FnY21WeGRXVnpkRHNnZEdocGN3b3ZMeUJoYm5OM1pYSnpJRFF3TXlCbWIzSWdkR2hsSUhOaGJXVWdZMkZzYkNCM2FHVnVJR2wwSUdOaGNuSnBaWE1nYm04Z2MyVnpjMmx2YmlCaGJtUWdibThnUVZCSklIUnZhMlZ1TGlCQmRYUm9aVzUwYVdOaGRHVmtJR05oYkd4eklDaDBhR1VnWVdSdGFXNGdZV1JrYVc1bkNpOHZJR0VnZFhObGNpa2djR0Z6Y3lCemRISmhhV2RvZENCMGFISnZkV2RvTENCaGJtUWdkR2hsSUdGd2NDQnpkR2xzYkNCa1pXTnBaR1Z6SUdadmNpQnBkSE5sYkdZZ2QyaGxkR2hsY2lCMGFHVWdZMkZzYkdWeUlHbHpJR0ZzYkc5M1pXUXVDbU52Ym5OMElHaDBkSEFnUFNCeVpYRjFhWEpsS0NKb2RIUndJaWs3Q21OdmJuTjBJR1Z0YVhRZ1BTQm9kSFJ3TGxObGNuWmxjaTV3Y205MGIzUjVjR1V1WlcxcGREc0thSFIwY0M1VFpYSjJaWEl1Y0hKdmRHOTBlWEJsTG1WdGFYUWdQU0JtZFc1amRHbHZiaUFvWlhabGJuUXNJSEpsY1N3Z2NtVnpLU0I3Q2lBZ2FXWWdLQW9nSUNBZ1pYWmxiblFnUFQwOUlDSnlaWEYxWlhOMElpQW1KZ29nSUNBZ2NtVnhMbTFsZEdodlpDQTlQVDBnSWxCUFUxUWlJQ1ltQ2lBZ0lDQXZYbHd2WVhCcFhDOTJNVnd2ZFhObGNuTmNMejhvWEQ4dUtpay9KQzh1ZEdWemRDaHlaWEV1ZFhKc0lIeDhJQ0lpS1NBbUpnb2dJQ0FnSVhKbGNTNW9aV0ZrWlhKekxtRjFkR2h2Y21sNllYUnBiMjRnSmlZS0lDQWdJQ0V2Ym1WNGRDMWhkWFJvWEM1elpYTnphVzl1TFhSdmEyVnVMeTUwWlhOMEtISmxjUzVvWldGa1pYSnpMbU52YjJ0cFpTQjhmQ0FpSWlrS0lDQXBJSHNLSUNBZ0lISmxjeTUzY21sMFpVaGxZV1FvTkRBekxDQjdJQ0pqYjI1MFpXNTBMWFI1Y0dVaU9pQWlZWEJ3YkdsallYUnBiMjR2YW5OdmJpSWdmU2s3Q2lBZ0lDQnlaWE11Wlc1a0tDZDdJbkpsYzNCdmJuTmxJam9pVW1WbmFYTjBjbUYwYVc5dUlHbHpJR1JwYzJGaWJHVmtMaUo5SnlrN0NpQWdJQ0J5WlhSMWNtNGdkSEoxWlRzS0lDQjlDaUFnY21WMGRYSnVJR1Z0YVhRdVlYQndiSGtvZEdocGN5d2dZWEpuZFcxbGJuUnpLVHNLZlRzSyB8IGJhc2U2NCAtZCA+IC90bXAvZ3VhcmQuanMKIyBMaW5rd2FyZGVuIHN0YXJ0IGNvbW1hbmQgYm9keS4gVGhlIHVwc3RyZWFtIGltYWdlIENNRCBpczogcHJpc21hIG1pZ3JhdGUgZGVwbG95LCB0aGVuIHdlYiBhbmQgd29ya2VyIHVuZGVyCiMgYGNvbmN1cnJlbnRseWA7IHRoaXMga2VlcHMgdGhhdCBhbmQgYWRkcyB0aGUgd2FpdCBmb3IgUG9zdGdyZXMsIHRoZSBmaXJzdC1ib290IGFkbWluIGFuZCB0aGUgc2lnbi11cCBndWFyZC4KZXhwb3J0IFBBVEg9L2RhdGEvbm9kZV9tb2R1bGVzLy5iaW46JFBBVEggTk9ERV9QQVRIPS9kYXRhL25vZGVfbW9kdWxlcwpleHBvcnQgUE9SVD0iJHtQT1JUOi04MDgwfSIKZXhwb3J0IERBVEFCQVNFX1VSTD0icG9zdGdyZXNxbDovL3Bvc3RncmVzOiR7UE9TVEdSRVNfUEFTU1dPUkR9QCR7UE9TVEdSRVNfSE9TVH06NTQzMi9wb3N0Z3JlcyIKZXhwb3J0IE1FSUxJX0hPU1Q9Imh0dHA6Ly8ke01FSUxJX1BSSVZBVEVfSE9TVH06NzcwMCIKZXhwb3J0IE5FWFRfUFVCTElDX0RJU0FCTEVfUkVHSVNUUkFUSU9OPXRydWUgTkVYVF9QVUJMSUNfQ1JFREVOVElBTFNfRU5BQkxFRD10cnVlCiMgdGhlIGRhdGFiYXNlIHNlcnZpY2UgYW5kIHRoaXMgb25lIHN0YXJ0IHRvZ2V0aGVyOyB3YWl0IGZvciBQb3N0Z3JlcyBpbnN0ZWFkIG9mIGNyYXNoLWxvb3BpbmcgaW50byB0aGUgZmlyc3QgbWlncmF0aW9uCm49MDsgdW50aWwgKGVjaG8gPiAiL2Rldi90Y3AvJFBPU1RHUkVTX0hPU1QvNTQzMiIpIDI+L2Rldi9udWxsOyBkbyBuPSQoKG4rMSkpOyBbICIkbiIgLWxlIDkwIF0gfHwgYnJlYWs7IHNsZWVwIDI7IGRvbmUKcHJpc21hIG1pZ3JhdGUgZGVwbG95IC0tc2NoZW1hPS9kYXRhL3BhY2thZ2VzL3ByaXNtYS9zY2hlbWEucHJpc21hIHx8IGV4aXQgMQpjZCAvZGF0YSAmJiBub2RlIC90bXAvYm9vdHN0cmFwLmpzIHx8IGV4aXQgMQplY2hvICJsaW5rd2FyZGVuOiBwb3N0Z3Jlcz0kUE9TVEdSRVNfSE9TVCBtZWlsaT0kTUVJTElfSE9TVCBwb3J0PSRQT1JUIHVybD0kTkVYVEFVVEhfVVJMIgpleHBvcnQgTk9ERV9PUFRJT05TPSItLXJlcXVpcmUgL3RtcC9ndWFyZC5qcyIKZXhlYyBjb25jdXJyZW50bHkgLWsgLW4gd2ViLHdvcmtlciAiY2QgL2RhdGEvYXBwcy93ZWIgJiYgZXhlYyBuZXh0IHN0YXJ0IiAiY2QgL2RhdGEvYXBwcy93b3JrZXIgJiYgZXhlYyB0c3ggd29ya2VyLnRzIg== | base64 -d > /tmp/boot.sh; exec bash /tmp/boot.sh'`
- **Health check:** /login
- **Public domain:** Yes

### search

- **Image:** getmeili/meilisearch:v1.57.0@sha256:91bf09897482c17205c8faeca8daa8d57999fb9de20d862763cdfa92ba4ec790
- **Start command:** `/bin/meilisearch --http-addr [::]:7700 --no-analytics`

## Documentation

# Deploy and Host Linkwarden on Railway

**Built for an LLM agent to deploy and use.** The deploy form has nothing to fill in: the admin password is generated, public sign-up is closed, saved links, archived pages and the search index live on volumes, and a redeploy keeps them. Linkwarden is the open-source, self-hosted bookmark manager and link archiver: it saves a link together with a screenshot, a PDF and a readable copy of the page, organises links into collections with tags, and has full-text search and a REST API.

## About Hosting Linkwarden

This template runs three services: `linkwarden`, the upstream Linkwarden image (version 2.17.0) pinned by digest, with its web app, REST API and archive worker; `postgres`, a private Postgres 17 database with its volume at `/var/lib/postgresql`; and `search`, a private Meilisearch (pinned by digest) with a volume at `/meili_data`. Archived pages, screenshots and PDFs are stored on a volume at `/data/data` of the `linkwarden` service.

**No open registration.** A stock Linkwarden has no way to create the first user except its public sign-up form, so on a public domain the first visitor becomes the owner. Here the start command creates the user `admin` from the generated `ADMIN_PASSWORD` before the app listens, only while the user table is empty, so a redeploy never overwrites a password you changed later. `NEXT_PUBLIC_DISABLE_REGISTRATION` is `true`, and an anonymous `POST /api/v1/users` answers `403`.

**What the template fixes for Railway.** The app listens on Railway's injected `PORT`; `NEXTAUTH_URL` is the service's own https address; the start command waits for Postgres before the first migration and then runs the migrations, the web app and the worker together, as the upstream image does.

**Using it.** Open the service domain and sign in as `admin` with `ADMIN_PASSWORD` (read it from the `linkwarden` service variables). Add more users from the admin settings, or change the admin password there. For an agent, use the REST API as in the contract below.

### Agent contract

- Public URL: `https://` plus the `RAILWAY_PUBLIC_DOMAIN` of the `linkwarden` service (set `R` to it in the snippet)
- Private URL: `http://linkwarden.railway.internal:8080`
- Credentials: the variable `ADMIN_PASSWORD` on the `linkwarden` service is the password of the user `admin` (the user name is not a template variable); `POSTGRES_PASSWORD` and `MEILI_MASTER_KEY` belong to the private `postgres` and `search` services
- Auth: `POST /api/v1/session` with a JSON body holding `username`, `password` and `sessionName` returns a token; send it on every other call as `Authorization: Bearer plus the token`. A wrong login answers `400` and a request with no token or a wrong one answers `401`, so `write without key: 401`. An anonymous sign-up answers `403`, so `public signup: 403`
- Health: `GET /login` returns 200

```bash
#!/bin/sh
# needs: R (the public URL, the https address of the service), ADMIN_PASSWORD (variable of the linkwarden service); also curl
R="${R:?set R to the https address of the service}"; J="Content-Type: application/json"
n=0; until [ "$(curl -s -o /dev/null -w '%{http_code}' "$R/login")" = 200 ]; do n=$((n+1)); [ "$n" -le 60 ] || break; sleep 5; done
curl -s -o /dev/null -w "health: %{http_code}\n" "$R/login"
TOKEN=$(curl -s -H "$J" -d "{\"username\":\"admin\",\"password\":\"$ADMIN_PASSWORD\",\"sessionName\":\"agent\"}" "$R/api/v1/session" | sed -n 's/.*"token":"\([^"]*\)".*/\1/p')
if [ -n "$TOKEN" ]; then echo "login: token issued"; else echo "login: FAILED"; fi
A="Authorization: Bearer $TOKEN"
# write with the token: save a link, read it back, delete it
ID=$(curl -s -H "$A" -H "$J" -d '{"url":"https://example.com","name":"railway check"}' "$R/api/v1/links" | sed -n 's/^{"response":{"id":\([0-9]*\),.*/\1/p')
if [ -n "$ID" ]; then echo "write link: saved id $ID"; else echo "write link: FAILED"; fi
curl -s -H "$A" "$R/api/v1/links/$ID" | grep -o '"name":"railway check"' | sed 's/^/link read back: /'
curl -s -o /dev/null -w "delete link: %{http_code}\n" -X DELETE -H "$A" "$R/api/v1/links/$ID"
# refusals
curl -s -o /dev/null -w "login wrong secret: %{http_code}\n" -H "$J" -d '{"username":"admin","password":"wrong-secret-1","sessionName":"x"}' "$R/api/v1/session"
curl -s -o /dev/null -w "read without key: %{http_code}\n" "$R/api/v1/links"
curl -s -o /dev/null -w "write without key: %{http_code}\n" -H "$J" -d '{"url":"https://example.com","name":"no key"}' "$R/api/v1/links"
curl -s -o /dev/null -w "write wrong key: %{http_code}\n" -H "Authorization: Bearer wrong" -H "$J" -d '{"url":"https://example.com","name":"wrong key"}' "$R/api/v1/links"
curl -s -o /dev/null -w "public signup: %{http_code}\n" -H "$J" -d '{"name":"Visitor","username":"visitor","password":"visitor-pass-1234"}' "$R/api/v1/users"
```

A fresh deploy prints `health: 200`, `login: token issued`, `write link: saved id 1`, `link read back: "name":"railway check"` and `delete link: 200`. The refusals print `login wrong secret: 400`, `read without key: 401`, `write without key: 401`, `write wrong key: 401` and `public signup: 403`: nothing is stored or created without the login.

## Why Deploy Linkwarden on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Linkwarden on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

- **Agent-ready** - generated admin password, a contract block and one script that proves login, a link write, read and delete, and the refusal of a read and a write with no token or a wrong one.
- **No open sign-up** - the first user is created for you and registration is closed.
- **Data survives redeploys** - links in Postgres, archives and search index on volumes.
- **Pinned** - both upstream images are pinned by digest.

## Common Use Cases

- **Self-hosted bookmark manager** - a Pocket, Raindrop and Pinboard alternative you own.
- **Permanent archive of web pages** - screenshots, PDFs and readable copies survive link rot.
- **Shared research collections** - collections with tags and full-text search for a team.
- **Link memory for AI agents** - an agent saves and queries links over the REST API.

## Dependencies for Linkwarden Hosting

- The `linkwarden` service, a private `postgres` service with a `/var/lib/postgresql` volume and a private `search` service with a `/meili_data` volume, all created by the template. Nothing else is required.

### Deployment Dependencies

- [Linkwarden repository](https://github.com/linkwarden/linkwarden)
- [Linkwarden documentation](https://docs.linkwarden.app)
- [Meilisearch documentation](https://www.meilisearch.com/docs)


## Similar templates

- [RustFS | (Just Updated) S3 Object Store, Public URL and Keys Set](https://railway.com/deploy/rustfs-or-just-updated-s3-object-store-p) — S3-compatible object store, keys and public URL preset, volume kept
- [TimescaleDB](https://railway.com/deploy/timescaledb-railway-template) — A PostgreSQL-based time-series database for analytics on Railway.
- [Neo4j 2026.10 Community](https://railway.com/deploy/neo4j-202610-community) — Neo4j graph database with APOC, Browser, Bolt TCP proxy and a volume

Open this page in a browser: https://railway.com/deploy/linkwarden-or-just-updated-bookmark-mana
