Repository navigation
Releases
Manta v1.3-beta
- Collect directory metadata relative to the already-open directory descriptor,
avoiding repeated parent-path traversal and per-entry wrapper allocations. - Keep root-confined, nonblocking MIME inspection and check the opened file
against the directory snapshot before reading it. Do not cache file contents,
MIME types or listings. - Add replacement regression tests for directories, internal/external symlinks,
named pipes and deleted files, plus nested-path and distinct-content benchmarks. - In a matched five-sample component test, 1,000-file root reads take 16.3% less
time and use 45.4% fewer allocations; nested reads take 28.3% less time. Raw
results, environment and reproduction commands are in benchmarks/LISTING.md.
These are component measurements, not a new live Wings comparison. - Pass Linux/macOS tests on amd64/arm64, race checks, lint and CodeQL. Refresh
Linux/macOS installation and update commands. Existing configuration, game data,
service names and API response formats are preserved; restart Manta per node.
Listings remain filesystem snapshots: files removed during enumeration may be
omitted, and files replaced before MIME inspection retain their snapshot metadata
with a generic MIME fallback. No configuration or data migration is required.
Manta v1.2-beta
- Include
product: mantain both system-information API versions so panels can
select Manta update checks without inferring the product from a version number.
Manta v1.1-beta.4 - Filesystem hardening
- Use nonblocking directory and file opens during walks, searches, archive reads
and MIME detection. Reject special files before reading them so a path changed
into a named pipe cannot block these operations. - Recheck opened archive files and their identity before writing tar headers.
Extend named-pipe and archive error regression coverage. - Add public contribution forms and private security-report links. Keep required
CI and branch protections mandatory, with a separate review-only exemption
for the current code owners. - Refresh Linux/macOS installation and update examples. Existing node
configuration and server data are preserved; no panel migration is required.
Manta v1.1-beta.3 ? startup pagination fix
- Start server-list pagination at page 1. This fixes startup HTTP 422 failures
against Aquadactyl panels that reject page zero, including on empty nodes. - Make pagination fixtures enforce the panel contract and cover single-page,
multi-page and empty-node responses, exact page coverage, bounded concurrency
and cancellation after failures. - Update installation, update and Docker instructions to this patched beta.
Preserve existing node configuration and server data; no panel migration is needed.
Upgrade an existing node
Update the existing source checkout before running its installer:
cd /opt/manta &&
git fetch --no-tags --depth 1 https://github.com/Aquadactyl/manta.git refs/tags/v1.1-beta.3 &&
git checkout --detach FETCH_HEAD &&
sudo bash scripts/install.sh v1.1-beta.3 &&
/usr/local/bin/manta version &&
sudo systemctl restart manta.service &&
sudo systemctl status manta.service --no-pagerKeep your existing node configuration and server data. No panel database migration or local Go rebuild is required for this fix. For nodes still managed by a legacy service, follow the service migration guide.
Manta v1.1-beta.2
Startup HTTP 422: Panels enforcing one-based pagination reject this release?s initial page-zero request. Upgrade to Manta v1.1-beta.3, which fixes the request.
- Ship native
mantabinaries,manta.service, Aquadactyl data/log/temp paths,
theaquadactylgame-file user and an Aquadactyl Docker network for new nodes. - Mark new configurations with
config_version: 1. Preserve omitted defaults in
old files, explicit custom paths, user IDs and existing activity databases. - Add canonical
MANTA_*environment overrides with legacy fallbacks, update
container entrypoints, Compose examples and macOS launchd executables. - Verify canonical and legacy service updates, duplicate-service rejection and
failed-start rollback. Document migration without silently relocating game data. - Publish
manta_*release assets alongside checksummed legacy aliases for old
update tooling, and update all current installation instructions.
Existing checkout or interrupted installation
If /opt/manta already exists, update the checkout instead of cloning again. A version argument selects the binary download; it does not update an older installer script. Run:
cd /opt/manta &&
git fetch --no-tags --depth 1 https://github.com/Aquadactyl/manta.git refs/tags/v1.1-beta.2 &&
git checkout --detach FETCH_HEAD &&
test -f deploy/manta.service &&
sudo bash scripts/install.sh v1.1-beta.2 &&
/usr/local/bin/manta versionEach step stops on failure. This fetch uses the published tag directly, independently of stale local tags. Git preserves untracked configuration and refuses conflicting changes. See service setup and migration before switching an existing daemon.
Manta v1.1-beta.1 — Aquadactyl configuration directory
Manta v1.1-beta.1 makes /etc/aquadactyl/config.yml the Linux configuration default, including Docker deployments.
Configuration behavior
- Fresh node configuration is written under /etc/aquadactyl with restrictive file permissions.
- When no explicit path was selected and the new default is absent, startup, diagnostics and configure can discover an existing /etc/pterodactyl/config.yml.
- The Aquadactyl configuration wins when both files exist. Invalid, unreadable or dangling canonical configurations do not silently load legacy credentials.
- Explicit --config and --config-path arguments are honored. Existing local data paths and other host settings are preserved during reconfiguration. Native macOS configuration locations remain unchanged.
- Existing configurations are not moved automatically. Follow the migration guide before changing a service or Docker mount, and retain the original file for rollback.
Install or update
Use the Git tools tag v1.1-beta.1. From an existing checkout:
cd /opt/manta
git fetch origin tag v1.1-beta.1
git checkout --detach v1.1-beta.1
sudo bash scripts/install.sh v1.1-beta.1For a new checkout, clone https://github.com/Aquadactyl/manta.git with --depth 1 --branch v1.1-beta.1. The installer replaces the binary; node configuration is a separate step in the guide. Back up configuration and game-server data before upgrading.
Docker: ghcr.io/aquadactyl/manta:v1.1-beta.1. New mounts use /etc/aquadactyl:/etc/aquadactyl; legacy mounts remain discoverable. Docker binaries now cross-compile on the build host instead of running the compiler under emulation.
Validation
Linux/macOS AMD64/ARM64 tests and race checks, lint and CodeQL pass. All four binary hashes and executable architectures were verified. Both Linux downloads report the release version and new default path. Docker tests cover fresh, canonical-only, legacy-only, dual-file, explicit-path and invalid-canonical cases; both image architectures and versions pass.
Manta v1.1-beta
Manta v1.1-beta completes the Aquadactyl / Euphoria Development branding and makes diagnostics local by default.
Changes
- Update configuration help, diagnostics, installation logs, errors, request User-Agent headers and the default application name to Manta/Aquadactyl.
- Identify Euphoria Development as the maintainer and retain upstream MIT attribution.
- Print diagnostics locally unless an operator explicitly selects a Hastebin-compatible upload URL and confirms the upload. No upstream paste service is selected by default.
- Refresh Linux/macOS installation and update commands, and pin the Docker Compose example to this beta image.
Install or update
For a new tools checkout:
git clone --depth 1 --branch v1.1-beta https://github.com/Aquadactyl/manta.git /opt/manta
cd /opt/manta
sudo bash scripts/install.sh v1.1-betaFor an existing checkout, back up configuration and server data, then:
cd /opt/manta
git fetch origin tag v1.1-beta
git checkout --detach v1.1-beta
sudo bash scripts/install.sh v1.1-beta
wings versionExisting command/service names, configuration and server-data paths, system users, Docker compatibility labels, API media types and backup adapter names remain compatible. Custom application names are preserved. Restarting Manta briefly disconnects console/SFTP sessions; schedule outside installs, backups and transfers. The installer keeps the previous binary for rollback.
Docker: ghcr.io/aquadactyl/manta:v1.1-beta. macOS uses the matching wings_darwin_arm64 or wings_darwin_amd64 download and the macOS guide. Verify every binary against the attached checksums.txt.
Validation
Linux and macOS on AMD64/ARM64 pass native tests and race checks; lint and CodeQL pass. All four release binaries have verified SHA256 hashes and executable architectures. Both Linux binaries report manta 1.1-beta, and an isolated offline installation confirms the version and preserves a rollback executable.
v1.0-beta
- Add a Git-distributed Linux release installer with architecture selection,
SHA256 and executable-version verification, atomic replacement and rollback
when restarting an active daemon fails. - Publish source tags with the matching runtime version before building Linux
and macOS binaries. Release packaging uploads artifacts for maintainer verification. - Document installation, Wings migration, HTTPS, service setup and recovery.
- Normalize verification scripts for Windows checkouts before running in Linux.
- Use the supplied Manta logo in project branding and installation
documentation. Keep inherited Wings executable/service names for deployment compatibility. - Linux verification passed 1,235 cases/subtests across 29 packages with race
detection andgo vet, with 98.70% full-module statement coverage. The separate
100% coverage audit target remains unmet.
Added
- Add an authenticated server file search endpoint that searches recursively beneath a supplied directory for case-insensitive path matches and returns up to 100 file paths.
- Add native macOS support for Apple Silicon (
arm64) and Intel (amd64). Manta manages containers through Docker Desktop, OrbStack, Colima or Rancher Desktop and runs unprivileged as the logged-in user. See Running Manta on macOS. - Add
wings_darwin_arm64andwings_darwin_amd64binaries to the release workflow and include them inchecksums.txt. - Add a macOS CI job that mirrors the Linux one: Go 1.27.4 on both architectures, each built and tested natively (Apple Silicon on
macos-26, Intel onmacos-26-intel). It runs the filesystem, configuration and macOS specific tests, also under the race detector, and uploads the binaries as artifacts. - Add built-in size based log rotation for macOS, which has no logrotate.
wings.logrotates at 10 MiB and seven old files are kept, unlesssystem.enable_log_rotateisfalse. Linux keeps using logrotate and reopening onSIGHUP. - Add host CPU, RAM and disk metrics to
GET /api/system/usageon macOS and advertisesystem_usagethere. CPU and RAM come from the Mach host statistics (host_statisticsandhost_statistics64) throughpurego, so the binary stays a static build without cgo. RAM used is added up the way Activity Monitor does it, application memory without purgeable pages plus wired and compressed memory, and total memory comes fromhw.memsize. Disk is the volume holding the server data. The tests compare the counters withvm_stat. - Add a launchd LaunchAgent (
macos/uk.aquadactyl.manta.plist) to start Manta at login and restart it if it stops, and a LaunchDaemon (macos/uk.aquadactyl.manta.daemon.plist) that starts it at boot as an ordinary user. - Add a startup check on macOS (
docker.mount_check, on by default) that runs a short container as the server user to find out whether the data directory is shared with the Docker runtime and writable, and says what to change when it is not, for example for the read-only home directory mount of Colima. - Discover the Docker socket on macOS when
DOCKER_HOSTis unset and/var/run/docker.sockis missing, checking Docker Desktop, OrbStack, Colima and Rancher Desktop in order. - Add
docker.image_pull_policyto control when images are pulled for server containers and installation containers.Always(the default) keeps the current behavior of pulling every time and carrying on with a local copy if the pull fails,IfNotPresentpulls only when the image reference does not resolve to a local image, andNeverfails with a clear error when the image is not present locally. Images prefixed with~are never pulled, as before. - Add
docker.network.interfaces.v6.enabled(defaulttrue) to turn IPv6 off on the Docker network Manta creates. IPv6 was always enabled before. It applies when the network is created, an existing network is left as it is. - Take
allowed_mountsfrom the Panel response when runningwings configure. The data directory stays local, so a stale daemon base in the Panel can not move existing servers. - Add
system.sftp.disable_password_authto disable SFTP password logins and require users to authenticate with an SSH key. - Add a security policy with instructions for reporting vulnerabilities.
Changed
- Replace the custom
internal/ufsfilesystem and Linuxopenat2path resolver with Go'sos.Root, which keeps operations beneath each server directory and removes thesystem.openat_modesetting. Filesystem operations now use the standard library's rooted APIs on Linux and macOS. - Use macOS locations for the default configuration, data, archive, backup, temporary, log and generated passwd directories. Defaults on Linux are unchanged and values set in the configuration file still take priority.
- Report the macOS version, build number and Darwin kernel version (for example
macOS 15.1 (24B83)) fromGET /api/systemusingsysctl, without/etc/os-releaseorsystem_profiler, so the panel can reach the node. The Darwin version fromunameis used if the product version is unavailable. - Detect the system timezone on macOS from
/etc/localtime. - Create the directory of the configuration file when it is missing before writing it.
- Skip the Linux only CPU burst cgroup update on other platforms instead of logging a warning for every container.
- Handle the SFTP sessions of a connection concurrently instead of one after another, and keep the connection open until all of them have finished. A failing session is logged and no longer ends the others.
- Print the version as
manta <version>fromwings version, without a secondvin front of a version that already has one. - Return an error from the configuration file parser for an unknown parser type instead of silently doing nothing.
- Stop building the JWT signer from an empty token in
config.Set, and clear it when the token is removed. - Migrate Docker integration to Moby's split client and API modules, updating container, image, network, attach, and statistics operations to the new API types.
- Migrate JWT parsing and claims to
golang-jwt/jwt/v5, preserving HS256 verification, required expiration, strict expiry boundaries, and the existing clock allowance for issuance and not-before claims. - Move scheduled activity and SFTP jobs to
gocron/v2. - Update Go dependencies, use Go 1.27.4 for CI and release builds, and refresh GitHub Actions versions. The CodeQL workflow has been removed.
- Expand platform and race-detector coverage for macOS, filesystem path resolution, Docker operations, configuration, transfers, and lifecycle handling.
- Update project and deployment references to Aquadactyl and Manta, including the Go module path, documentation links, and container image name.
Fixed
- Fix every installation and reinstallation failing with
install: cannot obtain installation lock. Since v0.2-betaInstallandReinstallset the installing state before starting the installation process, which then could not take the lock that was already held. The server is now marked as busy for the whole installation through a separate flag, so power actions are still refused while it stops, syncs and installs, and the installing state stays the lock of the installation process alone. A second installation that begins while one is running is rejected. - Run the descriptor leak regression test on every Unix platform by counting descriptors with
fcntlinstead of reading/proc/self/fd. - Fix S3 backup part uploads sending a truncated body when a retry was needed. Every attempt now reads the part again from its own offset in the file, where a retry used to continue with what was left of the body of the failed attempt.
- Report a failure to notify the Panel of a successful backup with its own error, instead of returning an unrelated earlier error value.
- Honor exclusive create requests (
SSH_FXF_CREATwithSSH_FXF_EXCL) over SFTP, so they fail with an error when the file exists instead of truncating it. - Improve error propagation and cleanup across filesystem and archive operations, Docker, transfers, and SFTP, including cancellation and failed I/O paths.
v0.3-beta
Added
- Add SELinux relabeling support for Docker bind mounts via the new
docker.selinux_relabelconfiguration option (sharedapplies thezlabel for paths used by multiple containers,privateappliesZfor a single container). When set, server containers (environment/docker/container.go) and installation containers (server/install.go) receive their mounts as bind specifications through the newenvironment.SELinuxBindshelper, preserving read-only flags, and unsupported values are rejected with an explicit error. Leaving the option empty keeps the existing mount behavior. - Add an isolated Docker verification workflow (
benchmarks/Run-Verification.ps1) and an exact coverage auditing tool (benchmarks/coverage_report.py) that records every uncovered source block and fails explicitly until the 100% target is reached, documented inbenchmarks/COVERAGE.md. - Add regression tests for malformed and truncated Docker inspect responses, invalid inspect request paths, malformed container start times, atomic JSON handling, quota file close failures after
Stat()errors, and transfer response body lifetime. - Add Red Hat based Linux deployment notes to the README covering Rocky Linux, AlmaLinux, Docker Engine setup, and SELinux bind mount configuration.
Changed
- Rename remaining project references from Wings to Manta across the CLI in
cmd/root.go, including the command name, help text, version output, debug and--auto-tlsflag descriptions, log messages, and the missing configuration notice, and reference Aquadactyl Panel instead of Pterodactyl Panel. - Replace the Pterodactyl startup banner with a Manta logo and update the website, source, and license links to
aquadactyl.ukand theAquadactyl/mantarepository. - Run CI coverage collection with
-coverpkg=./...so coverage is measured across the complete module rather than per package. - Refresh the Paper/Bedrock benchmark comparison against stock Wings v1.13.4 and retain the results under
benchmarks/results/verification-20261102, with all 14400 timed API requests completing without errors.
Fixed
- Resolve a response body leak in
PushArchiveToTarget(server/transfer/source.go) by closing the destination response body immediately after the request completes, instead of deferring the close inside the multipart branch. - Eliminate a timing-dependent failure in the outgoing transfer route test by using a controlled HTTP receiver that keeps the first transfer active while duplicate rejection and cancellation are checked, and by waiting for transfer completion before cleanup.
- Resolve races and collisions in existing router and lifecycle tests, including an explicit Docker network name for the root command lifecycle test.
Validation
- 823 race-detector test cases pass across 28 packages, with
go vetpassing. - Complete module statement coverage of 7565/8250 statements (91.70%); the 100% coverage target remains unmet and its gate fails explicitly.
- 16 live Manta checks pass, and the isolated benchmark suite completes 31 cases with five samples each.
- The outgoing transfer route test passed 1000 consecutive runs under race detection and full-module coverage instrumentation at a two-core quota.
v0.2-beta
Added
- Add workspace VS Code configuration (
.vscode/settings.json) targetingGOOS=linuxforgoplslanguage tools, eliminating false missing symbol warnings when developing on macOS or non-Linux host operating systems.
Changed
- Modernize atomic concurrency primitives across
systemandinternal/progresspackages to Go 1.19+ typed atomics (atomic.Bool,atomic.Uint64,atomic.Pointer[string],atomic.Pointer[T]), convertingAtomicBoolandAtomicStringfromsync.RWMutexto lock-free operations to eliminate lock contention on server state checks. - Bind background installation, reinstallation, and power action goroutines in the router to
Server.Context(), gracefully aborting operations and suppressing spurious error logs during server deletions and daemon shutdowns. - Guard server installation state by setting
Server.SetInstalling(true)duringInstall()andReinstall()lifecycles to block conflicting power actions and transfers. - Optimize streaming memory and throughput during archive creation and inter-daemon file transfers by increasing copy buffer sizes to 32KB/64KB and pooling buffers via
sync.Pool, eliminating per-file heap slice allocations.