Files
Juan DenisandClaude Opus 5 da2b77f3d2 feat(templates): tell people whether a template actually fits the server
Deploying checked three things — the name is free, the server row exists, the
directory isn't taken. Nothing asked whether the box could carry the thing, so
a 2 GB app landed on a 1 GB VPS at full speed and the first sign of trouble was
the OOM killer.

Every piece was already here and unconnected: templates describe what they cost
(`requirements: memory / storage`), servers report what they have
(Server.total_memory / total_disk) and what they are using (the newest
ServerMetrics sample). This is the join, answering in the shape a person asks
it — does it fit, will it be tight, or can't we tell?

Advisory on purpose. It reports; it never refuses. An estimate is an estimate,
real usage depends on configuration and traffic, so the operator keeps the
final say and "tight" is a sentence to read rather than a wall to argue with.
A full server still returns valid:true, and a test asserts that so this cannot
quietly become a gate.

Three judgements worth stating:

- The reserve is a floor-and-fraction pair (10% of the box, at least 256 MB RAM
  / 2 GB disk). A bare percentage is wrong at both ends: 10% of 1 GB is
  nothing, 10% of 64 GB is more than most apps need.
- `unknown` outranks `ok`. No recent sample, or a template that declares
  nothing, says so — a confident wrong answer is worse than no answer.
- Free memory comes from psutil's `available`, not `free`: cache and buffers
  are reclaimable, and counting them as used calls every healthy Linux box
  full.

Catalog coverage goes from 52/106 to 106/106. The 54 estimates are each app's
typical idle-to-light-use footprint, taken from the project's own documented
minimum where it publishes one and rounded to the values the existing 52
already use — sonarqube 4 GB because that is its documented heap floor, immich
4 GB for the ML models, prometheus 20 GB because retention dominates, traefik
256 MB.

Surfaced two ways: a capacity block alongside (never inside) `errors` on
validate-install, and a read-only GET the deploy drawer can poll while the
operator is still choosing a target, so the answer updates as they switch
servers instead of waiting for a submit.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-25 15:48:36 -04:00

95 lines
2.1 KiB
YAML

id: strapi
name: Strapi
version: "4.15"
description: Open-source headless CMS with customizable API and admin panel
icon: https://serverkit.ai/imgs/template-icons/strapi.svg
website: https://strapi.io
documentation: https://docs.strapi.io
categories:
- cms
- headless
- api
variables:
- name: HTTP_PORT
description: HTTP port
type: port
default: "1337"
hidden: true
- name: APP_KEYS
description: Application keys
type: password
generate: password
- name: API_TOKEN_SALT
description: API token salt
type: password
generate: password
- name: ADMIN_JWT_SECRET
description: Admin JWT secret
type: password
generate: password
- name: JWT_SECRET
description: JWT secret
type: password
generate: password
- name: DB_PASSWORD
description: PostgreSQL password
type: password
generate: password
ports:
- port: 1337
protocol: tcp
description: API and admin panel
volumes:
- name: app
path: /opt/app
description: Strapi application
- name: db
path: /var/lib/postgresql/data
description: PostgreSQL data
requirements:
memory: 2GB
storage: 4GB
compose:
services:
strapi:
image: strapi/strapi:${VERSION:-4.15}
container_name: ${APP_NAME}
restart: unless-stopped
environment:
- DATABASE_CLIENT=postgres
- DATABASE_HOST=db
- DATABASE_PORT=5432
- DATABASE_NAME=strapi
- DATABASE_USERNAME=strapi
- DATABASE_PASSWORD=${DB_PASSWORD}
- APP_KEYS=${APP_KEYS}
- API_TOKEN_SALT=${API_TOKEN_SALT}
- ADMIN_JWT_SECRET=${ADMIN_JWT_SECRET}
- JWT_SECRET=${JWT_SECRET}
volumes:
- strapi_app:/opt/app
ports:
- "${HTTP_PORT}:1337"
depends_on:
- db
db:
image: postgres:15-alpine
container_name: ${APP_NAME}-db
restart: unless-stopped
environment:
- POSTGRES_USER=strapi
- POSTGRES_PASSWORD=${DB_PASSWORD}
- POSTGRES_DB=strapi
volumes:
- strapi_db:/var/lib/postgresql/data
volumes:
strapi_app:
strapi_db: