# Changelog ## 0.0.11 - 2026-09-30 - The servers now log to their own journal (systemd log namespace `terraria`), which members of the `terraria` group can read. `attach` and `cmd` therefore show output to `terraria` group members without `sudo` or the `systemd-journal` group, and without access to the rest of the system's logs. Read it directly with `journalctl --namespace=terraria -u terraria@`. - New `/etc/systemd/journald@terraria.conf` for the servers' journal size and retention (default: up to 256 MB). - New internal `terractl journal-access`, run as root before each server start: creates the servers' journal folder (never `/var/log/journal` itself) and gives the `terraria` group read access, repairing existing journal files too. - The note shown by `attach` and `cmd` when output can't be read now distinguishes "not in the `terraria` group" from "in it, but the journal isn't set up yet". - Upgrading: running servers keep logging to the system journal until restarted; the package lists the ones to restart. ## 0.0.10 - 2026-09-30 - `cmd` now prints the server's reply to the command, instead of only saying where to find it. It waits until the server has been quiet for a second, up to 5 seconds. - `attach` and `cmd` now explain when you can send commands but not see the server's output. That happens for members of the `terraria` group who aren't root or in `systemd-journal`. Previously `attach` showed nothing, without saying why. - Replaced a `${var:+...}` expansion with an explicit `if` in `import`'s summary message (ShellCheck SC2016). The output is unchanged. ## 0.0.9 - 2026-09-28 - New `export` command: `terractl export [file.tar.gz] [--with-server]` archives an instance's `instance.conf`, `serverconfig.txt` and `data/` (worlds, mods, mod configs). If the server is running under systemd, it is asked to save first. Archives are created readable only by their owner, since `serverconfig.txt` can contain the server password. `--with-server` also includes the unpacked server software (and tModLoader's .NET), for hosts without internet access. - New `import` command: `terractl import ` creates an instance from an export, a `delete` backup, or an archive of an old `/opt/terraria` instance. Archives are checked before extracting (no paths outside the instance folder, no links or special files). Paths in `serverconfig.txt` are updated, a port already used by another instance is replaced with a free one, the server version the world was exported with is pinned, and ownership is set to the `terraria` user. - One server per instance: `run` holds a lock (`/.lock`) for the server's whole lifetime, released automatically when it exits or crashes. A second `run`, or starting the service while a copy started by hand is running, is refused. - `prepare` and `reinstall --clean` refuse to run while the instance's server is running, so `server/` and .NET are never replaced or deleted under it. - `delete` refuses to continue if the server is still running outside systemd. - `list` shows servers started by hand as `running (outside systemd)`. - `stop` typed by hand now explains to use `systemctl stop` instead of silently doing nothing. - Fixed relative paths given on the command line (e.g. `terractl mods add tmod-export`) being looked up from `/` instead of the current directory. - Bash completion for `export` and `import`. ## 0.0.8 - 2026-09-28 - Bash completion for `terractl`: commands, instance names, `new` types, console commands for `cmd`, `reinstall`/`delete` options, and `mods` actions and mod names. Installed to `share/bash-completion/completions/terractl` by both `make install` and the package. ## 0.0.7 - 2026-09-28 - Fixed ShellCheck warnings that made `make check` (and therefore `make deb`) fail when ShellCheck is installed: simplified the development-copy check in `--version` (SC2140), and marked the intentional unquoted unit list in `prerm` (SC2086). ## 0.0.6 - 2026-09-28 - Renamed the command from `terraria-instance` to `terractl`, and the package from `terraria-instance` to `terraria-server-manager`. The new package replaces the old one automatically; see "Upgrading from the terraria-instance package" in the guide. - Settings file moved from `/etc/default/terraria-instance` to `/etc/default/terractl`. - New `terractl --version`. - New Makefile: `make check`, `make deb`, `make install`, `make uninstall`. - Restructured the source into a git repository layout. ## 0.0.5 - 2026-09-28 - Fixed `attach`: detaching with Ctrl-D printed "jpid: unbound variable" and left a `journalctl` process running. ## 0.0.4 - 2026-09-28 - The .NET runtime that tModLoader downloads on first start (and its logs) is now kept when an instance is upgraded or re-unpacked. - New `reinstall --clean` to discard .NET as well and download it again. ## 0.0.3 - 2026-09-28 - New `mods` command: `list`, `add`, `enable`, `disable`, `remove`. Accepts the Windows export folder directly and sets file ownership. - `new` and `prepare` now create `data/Mods` for tModLoader instances. ## 0.0.2 - 2026-09-28 - Fixed `prepare` failing for tModLoader zips when run as root from a directory the `terraria` user can't enter (e.g. `/root`). ## 0.0.1 - 2026-09-28 - First Debian package. Uses `/var/lib/terraria` instead of `/opt/terraria` and `/terraria`, creates the `terraria` user and directories with sysusers.d and tmpfiles.d, and stops instances cleanly when removed. - `prepare` and `run` switch to the `terraria` user when started as root, so no files end up owned by root. - New `delete` command, with an automatic backup. - `list` no longer aborts when an instance's config can't be read.