mirror of
https://github.com/jhd3197/ServerKit.git
synced 2026-10-26 13:06:57 +09:00
Juan DenisandClaude Opus 5
da2b77f3d2
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>
84 lines
1.8 KiB
YAML
84 lines
1.8 KiB
YAML
id: bookstack
|
|
name: BookStack
|
|
version: "23.12"
|
|
description: Simple, self-hosted platform for organizing and storing information
|
|
icon: https://serverkit.ai/imgs/template-icons/bookstack.png
|
|
website: https://www.bookstackapp.com
|
|
documentation: https://www.bookstackapp.com/docs/
|
|
categories:
|
|
- productivity
|
|
- wiki
|
|
- documentation
|
|
|
|
variables:
|
|
- name: HTTP_PORT
|
|
description: HTTP port
|
|
type: port
|
|
default: "8080"
|
|
hidden: true
|
|
- name: APP_URL
|
|
description: Application URL
|
|
default: http://localhost:8080
|
|
required: true
|
|
- name: DB_PASSWORD
|
|
description: MySQL password
|
|
type: password
|
|
generate: password
|
|
|
|
ports:
|
|
- port: 8080
|
|
protocol: tcp
|
|
description: Web interface
|
|
|
|
volumes:
|
|
- name: config
|
|
path: /config
|
|
description: BookStack configuration
|
|
|
|
requirements:
|
|
memory: 512MB
|
|
storage: 2GB
|
|
|
|
compose:
|
|
services:
|
|
bookstack:
|
|
image: linuxserver/bookstack:${VERSION:-23.12.3}
|
|
container_name: ${APP_NAME}
|
|
restart: unless-stopped
|
|
environment:
|
|
- PUID=1000
|
|
- PGID=1000
|
|
- TZ=UTC
|
|
- APP_URL=${APP_URL}
|
|
- DB_HOST=db
|
|
- DB_PORT=3306
|
|
- DB_USER=bookstack
|
|
- DB_PASS=${DB_PASSWORD}
|
|
- DB_DATABASE=bookstackapp
|
|
volumes:
|
|
- bookstack_config:/config
|
|
ports:
|
|
- "${HTTP_PORT}:80"
|
|
depends_on:
|
|
- db
|
|
|
|
db:
|
|
image: mariadb:10.11
|
|
container_name: ${APP_NAME}-db
|
|
restart: unless-stopped
|
|
environment:
|
|
- MYSQL_ROOT_PASSWORD=${DB_PASSWORD}
|
|
- MYSQL_DATABASE=bookstackapp
|
|
- MYSQL_USER=bookstack
|
|
- MYSQL_PASSWORD=${DB_PASSWORD}
|
|
volumes:
|
|
- bookstack_db:/var/lib/mysql
|
|
|
|
volumes:
|
|
bookstack_config:
|
|
bookstack_db:
|
|
|
|
post_install: |
|
|
echo "Default credentials: admin@admin.com / password"
|
|
echo "Please change the password after first login!"
|