Files
Chronos/deploy/docker/entrypoint.sh
T
Claude 650a82a8f7 fix(docker): start on a fresh archive folder and fix the Unraid defaults
A bind source Docker creates on demand (the compose default, a new
TITANO_ARCHIVE, the image's anonymous volume) is root-owned, so the server,
running as PUID:PGID, crash-looped with a stack trace (DOCKER-2). The
entrypoint now gives an archive mount root that user cannot write to
PUID:PGID when it is empty or owned by root (the folder only, never its
contents), and otherwise exits with a one-line error; it creates and owns
TITANO_DATA_PATH instead of a hard-coded /data (DEPLOY-1), and --help and
--healthcheck touch neither folder. The runtime image empties
ASPNETCORE_HTTP_PORTS, so Kestrel no longer warns "Overriding address(es)"
at every start (DOCKER-6).

Unraid template: the database host defaults to empty and required, since
container names do not resolve on the default bridge (SRS-08, DOCKER-3); a
Public HTTPS port variable goes with a remapped HTTPS port (DOCKER-4); the
time zone description no longer claims logs use it (DOCKER-8). Compose,
.env.example and the public README document the archive folder's owner,
public ports, trusted proxies, that LAN discovery needs host networking
(DOCKER-5), the Unraid database host, and that the Windows service
registers only from Program Files (SRS-06).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
2026-10-12 09:27:31 +00:00

42 lines
1.6 KiB
Bash
Executable File

#!/bin/sh
# Runs Titano Server as PUID:PGID (Unraid/NAS convention). The data folder is owned by that user. The archive is left
# as mounted (it may hold terabytes) and only checked for write access; only when that user cannot write it and the
# folder is empty or owned by root (Docker creates a missing bind source or a fresh volume that way) is the folder
# itself, never its contents, given to PUID:PGID.
set -eu
PUID="${PUID:-1000}"
PGID="${PGID:-1000}"
DATA="${TITANO_DATA_PATH:-/data}"
ARCHIVE="${TITANO_ARCHIVE_PATH:-/archive}"
umask 002
# Help and the health probe touch neither folder.
case "${1:-}" in
--help | -h | -\? | /\? | --healthcheck) exec dotnet /app/Titano.Server.dll "$@" ;;
esac
as_user() {
setpriv --reuid="$PUID" --regid="$PGID" --clear-groups -- "$@"
}
if [ "$(id -u)" = "0" ]; then
mkdir -p "$DATA" "$ARCHIVE"
chown -R "$PUID:$PGID" "$DATA"
if ! as_user test -w "$ARCHIVE"; then
if [ -z "$(ls -A "$ARCHIVE")" ] || [ "$(stat -c %u "$ARCHIVE")" = "0" ]; then
owner="$(stat -c %u:%g "$ARCHIVE")"
if chown "$PUID:$PGID" "$ARCHIVE" 2>/dev/null; then
echo "titano: $ARCHIVE belonged to $owner; it now belongs to $PUID:$PGID (the folder only, not its contents)"
fi
fi
if ! as_user test -w "$ARCHIVE"; then
echo "error: $ARCHIVE is not writable by $PUID:$PGID; give that user write access to the archive folder on the host, or set PUID and PGID to its owner" >&2
exit 1
fi
fi
exec setpriv --reuid="$PUID" --regid="$PGID" --clear-groups -- dotnet /app/Titano.Server.dll "$@"
fi
exec dotnet /app/Titano.Server.dll "$@"