littlelink v0.1.0

Apps

LittleLink Server — a lightweight, self-hosted link-in-bio page (a Linktree alternative). One tidy page of your links and social buttons, configured entirely through environment variables — stateless, no database. Deployed as a host-networked Nomad service.

nomad-pack run littlelink --registry nomploy

…or one line (add registry + run)

curl -fsSL https://packs.nomploy.com/install.sh | sh -s -- littlelink

Needs nomad-pack on PATH. The script only adds the nomploy registry and runs this pack.

Source ↗ Project ↗ ★ 1.1k ⚑ Report an issue

1 task http 3000 image timothystewart6/littlelink-server:latest tracks :latest image bumped today

Variables 12

values.hcl

Save as values.hcl, edit, then run:

nomad-pack run littlelink -f values.hcl --registry nomploy

# The name of the Nomad job.
job_name = "littlelink"

# The Nomad namespace to deploy into.
namespace = "default"

# The datacenters to deploy to.
datacenters = ["*"]

# The LittleLink Server container image. Pin a tag in production.
image = "timothystewart6/littlelink-server:latest"

# Host port for the page. The container listens on 3000.
port = 3000

# Display name / page title (NAME).
name = "Your Name"

# Color theme (THEME): auto, light, or dark.
theme = "auto"

# Short bio shown under your name (DESCRIPTION).
description = "My links"

# URL of the avatar image (AVATAR_URL). Empty = the default avatar.
avatar_url = ""

# How many instances to run. LittleLink is stateless, so you can run several.
count = 1

# Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []

# Resources for the LittleLink task.
resources = {
    cpu    = 200
    memory = 128
  }

Name	Type	Default	Description
job_name	string	"littlelink"	The name of the Nomad job.
namespace	string	"default"	The Nomad namespace to deploy into.
datacenters	list	["*"]	The datacenters to deploy to.
image	string	"timothystewart6/littlelink-server:latest"	The LittleLink Server container image. Pin a tag in production.
port	number	3000	Host port for the page. The container listens on 3000.
name	string	"Your Name"	Display name / page title (NAME).
theme	string	"auto"	Color theme (THEME): auto, light, or dark.
description	string	"My links"	Short bio shown under your name (DESCRIPTION).
avatar_url	string	""	URL of the avatar image (AVATAR_URL). Empty = the default avatar.
count	number	1	How many instances to run. LittleLink is stateless, so you can run several.
constraints	list	[]	Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
resources	object	{ cpu = 200 memory = 128 }	Resources for the LittleLink task.

Readme

littlelink

LittleLink Server — a lightweight, self-hosted link-in-bio page and a Linktree alternative. One clean page with your bio and social/link buttons, configured entirely through environment variables — stateless, no database.

Single host-networked Nomad service; raise count to run several.

Deploy

nomad-pack registry add nomploy https://github.com/Nomploy/nomad-packs
nomad-pack run littlelink --registry=nomploy

Configure

Variable	Default	Description
`port`	`3000`	Page port. The container listens on 3000.
`name`	`Your Name`	Display name / title (`NAME`).
`theme`	`auto`	`THEME`: `auto`, `light`, or `dark`.
`description`	`My links`	Short bio (`DESCRIPTION`).
`avatar_url`	`""`	Avatar image URL (`AVATAR_URL`); empty = default.
`count`	`1`	Instances to run (stateless — safe to scale).
`image`	`timothystewart6/littlelink-server:latest`	Container image. Pin a tag in production.
`resources`	`{ cpu = 200, memory = 128 }`	Task resources.

The page is fully driven by env vars. Add social handles and custom buttons — TWITTER, GITHUB, EMAIL, BUTTON_1_URL/BUTTON_1_TEXT, etc. — per the LittleLink Server docs. To change the port, keep port in sync with PORT (already wired). Serves plain HTTP — front it with a reverse proxy for TLS.