Settings Reference
Every environment variable the SealSkin server reads, with its default.
Every setting is read once at start-up from an environment variable named
SEALSKIN_<NAME>. Booleans accept true, 1 or yes (anything else is
false); an unparsable integer falls back to the default with an error in the
log. When the server runs in the
linuxserver/sealskin
container the defaults already point at the /config and /storage volumes,
so most installations set none of these.
HOST_URL is the one variable without the prefix: it is read by the
first-run admin bootstrap and written into /config/admin.json as the
server address. See Configuration for the files these
paths refer to.
| Variable | Type | Default | Description |
|---|---|---|---|
SEALSKIN_LOG_LEVEL | str | INFO | Logging level (e.g., DEBUG, INFO, WARNING). |
SEALSKIN_API_PORT | int | 8000 | Port for the main API server. |
SEALSKIN_SESSION_PORT | int | 8443 | Port for the session proxy server. |
SEALSKIN_DEFAULT_PROVIDER | str | docker | The default application provider to use. |
SEALSKIN_APP_RESOURCE_PATH | str | https://raw.githubusercontent.com/linuxserver/sealskin-apps/refs/heads/master/apps.yml | URL for the YAML file defining default available applications. |
SEALSKIN_INSTALLED_APPS_PATH | str | /config/.config/sealskin/installed_apps.yml | Path to the YAML file for installed application configurations. |
SEALSKIN_APP_STORES_PATH | str | /config/.config/sealskin/app_stores.yml | Path to the YAML file defining available app stores. |
SEALSKIN_APP_TEMPLATES_PATH | str | /config/.config/sealskin/app_templates | Path to the directory for user-defined application templates. |
SEALSKIN_DEFAULT_APP_TEMPLATES_PATH | str | app/default_templates | Path to the directory for default application templates. |
SEALSKIN_UPLOAD_DIR | str | /storage/sealskin_uploads | Directory for temporary file uploads (one sub-directory per user). |
SEALSKIN_SESSION_COOKIE_NAME | str | sealskin_session_token | Name of the session cookie. |
SEALSKIN_AUTOSTART_CACHE_PATH | str | /config/.config/sealskin/autostart_cache | Path to cache autostart scripts. |
SEALSKIN_APP_STORE_CACHE_PATH | str | /config/.config/sealskin/app_stores_cache | Path to cache app store YAML files. |
SEALSKIN_AUTO_UPDATE_APPS | bool | true | Enable automatic pulling of the latest app images in the background. |
SEALSKIN_AUTO_UPDATE_INTERVAL_SECONDS | int | 3600 | How often to check for app image updates (in seconds). |
SEALSKIN_PUID | int | 1000 | Default User ID to run containers as. |
SEALSKIN_PGID | int | 1000 | Default Group ID to run containers as. |
SEALSKIN_KEYS_BASE_PATH | str | /config/.config/sealskin/keys | Base directory for admin and user public keys. |
SEALSKIN_GROUPS_BASE_PATH | str | /config/.config/sealskin/groups | Base directory for group definition files. |
SEALSKIN_STORAGE_PATH | str | /storage | Base directory for user home directories. |
SEALSKIN_APP_ICONS_PATH | str | /storage/sealskin_app_icons | Directory for storing custom-uploaded application icons. |
SEALSKIN_HOME_TEMPLATES_PATH | str | /storage/sealskin_home_templates | Base directory for meta-app home directory templates. |
SEALSKIN_CONTAINER_CONFIG_PATH | str | /config | Mount point for home directories inside the container. |
SEALSKIN_SERVER_PRIVATE_KEY_PATH | str | /config/ssl/server_key.pem | Path to the server private key PEM file. |
SEALSKIN_PROXY_KEY_PATH | str | /config/ssl/proxy_key.pem | Path to the proxy SSL private key file. |
SEALSKIN_PROXY_CERT_PATH | str | /config/ssl/proxy_cert.pem | Path to the proxy SSL certificate file. |
SEALSKIN_PUBLIC_STORAGE_PATH | str | /storage/sealskin_public | Directory for storing publicly shared files. |
SEALSKIN_PUBLIC_SHARES_METADATA_PATH | str | /config/.config/sealskin/public_shares.yml | Path to the YAML file for public share metadata. |
SEALSKIN_SHARE_CLEANUP_INTERVAL_SECONDS | int | 600 | How often to run the cleanup job for expired shares (in seconds). |
SEALSKIN_SESSIONS_DB_PATH | str | /config/.config/sealskin/sessions.yml | Path to the YAML file for session persistence. |
SEALSKIN_CADDYFILE_PATH | str | /config/.config/sealskin/Caddyfile | Path to the generated Caddyfile for the proxy. |
SEALSKIN_UI_PATH | str | app/ui inside the installed package, else <repo>/client/dist/ui | Directory holding the built web UI served under /ui. |
SEALSKIN_TEMPLATE_SCHEMA_PATH | str | template_schema.yml next to the server package | YAML file describing the environment variables editable in app templates. |
SEALSKIN_CRYPTO_SESSION_TTL_SECONDS | int | 86400 | Idle lifetime of an E2EE session key before it is discarded. |
SEALSKIN_WATCH_CONFIG_FILES | bool | true | Reload YAML configuration files automatically when they change on disk. |