Skip to content
AquadactylAquadactyl
Manta

Additional Configuration

Advanced Manta configuration for Aquadactyl, including SSL/TLS certificates, firewall ports and Docker daemon tuning.

Fine-tune your Manta node for security, custom ports and Docker networking. Manta is the Aquadactyl server daemon, maintained by Euphoria Development.

Linux configuration now defaults to /etc/aquadactyl/config.yml. Existing legacy files remain discoverable when the default is absent. Follow the configuration migration guide before moving an existing node. Use the manta command and manta.service for new nodes.

SSL / TLS Certificates

When your Aquadactyl Panel is served over HTTPS, web browsers require Manta to use SSL/TLS to prevent mixed content blocking when connecting to the console websocket (port 8080).

1. Generate Certificates with Certbot

Ensure your node's FQDN (e.g. node1.yourdomain.com) points to the node's public IP address:

sudo apt install -y certbot
sudo certbot certonly --standalone -d node1.yourdomain.com

2. Update Manta Configuration

Open /etc/aquadactyl/config.yml:

/etc/aquadactyl/config.yml
api:
  host: 0.0.0.0
  port: 8080
  ssl:
    enabled: true
    cert: /etc/letsencrypt/live/node1.yourdomain.com/fullchain.pem
    key: /etc/letsencrypt/live/node1.yourdomain.com/privkey.pem

Restart Manta to apply the certificate:

sudo systemctl restart manta

Firewall & Port Rules (UFW)

Manta and hosted game servers require specific incoming ports to function:

Port / ProtocolServiceDescription
8080/tcpDaemon API & WebsocketsPanel-to-node communication and live console
2022/tcpBuilt-in SFTPServer file management via SFTP clients
80/tcpCertbot HTTP-01Let's Encrypt certificate issuance & renewals
25565-25600/tcp+udpGame AllocationsPorts allocated to game servers (adjust as needed)

Configure UFW:

Allow Manta ports in UFW
sudo ufw allow 8080/tcp
sudo ufw allow 2022/tcp
sudo ufw allow 80/tcp
# Example game port range:
sudo ufw allow 25565:25600/tcp
sudo ufw allow 25565:25600/udp
sudo ufw reload

Docker Daemon Tuning

Configure /etc/docker/daemon.json for reliable container DNS and logging limits:

/etc/docker/daemon.json
{
  "log-driver": "local",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  },
  "dns": ["1.1.1.1", "8.8.8.8"]
}

Restart Docker and Manta:

sudo systemctl restart docker
sudo systemctl restart manta

Manta Docker Options

These options live under the docker section of /etc/aquadactyl/config.yml and are specific to Manta. Restart Manta after changing them.

Image Pull Policy

docker.image_pull_policy controls when Manta pulls an image before it creates a container. It applies to server containers and to the containers that run server installation scripts.

/etc/aquadactyl/config.yml
docker:
  image_pull_policy: IfNotPresent
ValueBehavior
AlwaysPull every time. This is the default. If the pull fails but a local copy exists, Manta logs a warning and carries on with it
IfNotPresentPull only when no local image has that exact tag
NeverNever pull. Creating the container fails with an error saying the image is not present locally, so images have to be loaded onto the node beforehand

Images whose name starts with ~ are local images and are never pulled, whatever the policy is.

IfNotPresent and Never are useful on nodes with a slow or metered connection, behind a registry mirror, or without internet access. With IfNotPresent, an image that is referenced by a moving tag such as latest is not updated until you pull it yourself.

IPv6 on the Docker Network

Manta creates a Docker network for servers when it starts. IPv6 is enabled on it by default. To create it without IPv6, for example on a host that has no IPv6 connectivity:

/etc/aquadactyl/config.yml
docker:
  network:
    interfaces:
      v6:
        enabled: false

This only applies when the network is created. A network that already exists keeps its settings, so remove it first if you want the change to take effect. Make sure no servers are using it, then restart Manta so it creates the network again.

Mount Check (macOS)

docker.mount_check (default true) makes Manta on macOS check at startup that containers can write to the server data directory. It has no effect on Linux. See Installing Manta on macOS for what it reports.