Host requirements
Server requirements for Talesmith node, hub, and plugins. On first node setup, use Check host on the setup screen to compare your server against this list (hub operators can call the same check on hub.php?action=check_host).
| Requirement | Recommended | Minimum install |
|---|---|---|
| PHP | 8.2+ (web SAPI; lowest branch receiving security fixes) | 8.0.28+ (out of support; install allowed) |
json | Enabled (bundled with PHP; confirm not stripped on the host) | Enabled |
pdo / pdo_sqlite | Enabled | Node: not required (core install; plugins disabled). Hub: required. |
zip | Enabled (ZipArchive) | Enabled |
fileinfo | Enabled | ? — install allowed; upload MIME checks may fail |
gd | Enabled | ? — install allowed; image resize/re-encode unavailable |
mbstring | Enabled | ? — install allowed; multibyte text may truncate incorrectly |
tokenizer | Enabled | ? — install allowed; layer 3 contract plugins disabled |
openssl | Enabled | Enabled |
| Outbound HTTP | curl enabled or allow_url_fopen=On. Prefer curl: parallel outbound requests. | allow_url_fopen=On without curl; performance impacted |
memory_limit | 128M minimum | ? — 64M (wall aggregation and large requests may fail) |
post_max_size | 8M minimum | ? — 2M (small posts only) |
upload_max_filesize | 8M minimum | ? — 2M (small uploads only) |
max_execution_time | 60 minimum | ? — 30 (long refreshes may time out) |
session.save_path | Writable by web server user | Writable by web server user |
| System temp directory | Writable by web server user | Writable by web server user |
disable_functions | Must not block curl_exec, curl_multi_exec, curl_multi_init when using curl | Not applicable if only allow_url_fopen is used |
data/ location | Directory beside node.php or hub.php | Same |
data/ ownership | Unix: owned by the web server user, or group includes that user with group write | Same |
data/ directory mode | 775 minimum (or 755 if the web server user is the owner). Application may apply 0777 on created dirs when umask allows. | 755 if the web server user owns data/ |
data/ file mode | 644 for files written by the application | 644 |
| Hub plugin URL routing | Apache: mod_rewrite and a writable .htaccess at the hub install root. nginx: equivalent rewrite / try_files to hub.php. IIS: URL Rewrite to hub.php. Node plugins: query URLs only. | Hub: query URLs only (hub.php?ts_plugin=…&ts_plugin_path=…); rewrite not required. Node: unchanged. |
? — Between minimum and recommended: install proceeds with reduced or degraded capability. The setup Check host table uses ✓ (recommended), ? (minimum), and ✗ (below minimum).