---
title: "Deploy linkpage"
description: "FOSS self-hosted link-in-bio page — Linktree alternative with analytics"
category: "Starters"
url: https://railway.com/deploy/linkpage
---

# Deploy linkpage

FOSS self-hosted link-in-bio page — Linktree alternative with analytics

**[Deploy linkpage on Railway](https://railway.com/template/linkpage)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/linkpage/manifest.json

- **Creator:** Sethumadhavan K's Projects
- **Category:** Starters

## Template content

### linkpage

- **Image:** rhnvrm/linkpage:v0.5.0
- **Start command:** `/bin/sh -c 'mkdir -p /data && cat > /data/config.toml <<EOF
http_address="0.0.0.0:8000"
read_timeout="10s"
write_timeout="10s"
dbfile="/data/app.db"
page_logo_url="/static/app/img/logos/logo-icon-only.png"
page_title="${PAGE_TITLE}"
page_intro="${PAGE_INTRO}"
static_files="static/custom"

[auth]
username="${LINKPAGE_ADMIN_USERNAME}"
password="${LINKPAGE_ADMIN_PASSWORD}"

[social]
github = "${SOCIAL_GITHUB}"
twitter = "${SOCIAL_TWITTER}"
linkedin = "${SOCIAL_LINKEDIN}"
instagram = "${SOCIAL_INSTAGRAM}"
youtube = "${SOCIAL_YOUTUBE}"
facebook = "${SOCIAL_FACEBOOK}"
EOF
exec ./linkpage --config /data/config.toml' `
- **Public domain:** Yes

## Documentation

# Deploy and Host LinkPage on Railway

[LinkPage](https://github.com/rhnvrm/linkpage) is a FOSS self-hosted link-in-bio page — a lightweight alternative to Linktree and Campsite.bio. It offers an editorial design, click analytics, OpenGraph metadata fetching, and a Basic Auth admin panel, backed by SQLite.

**One-click deploy:** https://railway.com/deploy/linkpage

## About Hosting LinkPage

This template runs the public Docker image `rhnvrm/linkpage:v0.5.0` with a persistent volume at `/data` for the SQLite database. On start, Railway writes `config.toml` from environment variables (admin credentials, page title/intro, optional social links) and launches the server on port 8000. Generate a public domain, open the home page, then manage links at `/admin` with your admin username and password. Schema migrates automatically on first boot.

## Common Use Cases

- Personal or creator link-in-bio page on a custom domain
- Team or brand landing page with tracked outbound links
- Self-hosted alternative to Linktree without SaaS lock-in

## Dependencies for LinkPage Hosting

- Persistent volume — `/data` for SQLite (`app.db`) and generated config
- Public domain — HTTP access to the page and `/admin`
- Admin credentials — username and password for the Basic Auth admin panel

### Deployment Dependencies

- [LinkPage repository](https://github.com/rhnvrm/linkpage)
- [Public Docker image](https://hub.docker.com/r/rhnvrm/linkpage) — `rhnvrm/linkpage:v0.5.0`
- [Documentation](https://rhnvrm.github.io/linkpage/)

### Implementation Details

At deploy time you mainly set:

- `LINKPAGE_ADMIN_USERNAME` — admin login (default `admin`)
- `LINKPAGE_ADMIN_PASSWORD` — admin password (auto-generated; save it)

Optional: `PAGE_TITLE`, `PAGE_INTRO`, and `SOCIAL_*` URLs. The app image is linux/amd64 only.

## Why Deploy LinkPage 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 LinkPage 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.


## Similar templates

- [open-excalidraw](https://railway.com/deploy/open-excalidraw) — Self-hostable collaborative drawing built on Excalidraw
- [caring-vibrancy](https://railway.com/deploy/caring-vibrancy) — Deploy and Host caring-vibrancy with Railway
- [Appsmith](https://railway.com/deploy/appsmith-1) — Low-code platform for internal tools, dashboards, and admin panels.

Open this page in a browser: https://railway.com/deploy/linkpage