meowsers/deploycat repository overview

⁠DeployCat

Your Own server... Right Meow www.deploycat.app⁠

DeployCat is a game server manager that makes it easy to create, configure, and manage multiple game servers from a web interface. Supports Minecraft (Java + Bedrock + Modded), Steam games (ARK, Rust, Palworld, Satisfactory, CS2, Valheim, V Rising, and 25+ more)

--- Terms of Service: deploycat.app/terms⁠

⁠Quick Start

docker run -d \
  --name deploycat \
  --network host \
  --stop-timeout 40 \
  --device /dev/net/tun \
  --cap-add NET_ADMIN \
  -v /path/to/your/data:/data \
  -e PORT=8732 \
  -e TZ=America/New_York \
  -e PUID=1000 \
  -e PGID=1000 \
  meowsers/deploycat:latest

Then open http://your-server-ip:8732⁠ in your browser.

⁠⚠️ Network Mode — READ THIS FIRST

DeployCat works best with Host networking. (actually this is a MUST) Host mode lets game servers use any port without manual port mapping, and enables UPnP auto port-forwarding to your router.

--network host

If you must use Bridge mode, you need to manually map every port for every game server you create. UPnP will NOT work in bridge mode. See the Bridge Mode section below.

⁠Volume Mappings

⁠Example with all mounts:

docker run -d \
  --name deploycat \
  --network host \
  --stop-timeout 40 \
  --device /dev/net/tun \
  --cap-add NET_ADMIN \
  -v /mnt/user/appdata/deploycat:/data \
  -v /mnt/user/appdata2/ssdservers:/mnt/drive2 \
  -v /mnt/remotes/backups/dcbackups:/mnt/backupdrive \
  -v /var/run/tailscale:/var/run/tailscale \
  -e PORT=8732 \
  -e TZ=America/Chicago \
  -e PUID=99 \
  -e PGID=100 \
  -e TS_SOCKET=/var/run/tailscale/tailscaled.sock \
  meowsers/deploycat:latest

⁠Environment Variables

⁠Data Directory Overrides (Advanced)

These are set in the Dockerfile and rarely need changing. All point inside /data:

⁠Docker Run (Full Example)

This is the recommended configuration with all common options:

docker run -d \
  --name deploycat \
  --restart unless-stopped \
  --network host \
  --stop-timeout 40 \
  --device /dev/net/tun \
  --cap-add NET_ADMIN \
  -v /path/to/your/data:/data \
  -e PORT=8732 \
  -e TZ=America/New_York \
  -e PUID=1000 \
  -e PGID=1000 \
  meowsers/deploycat:latest

Flag explanations:

⁠Docker Compose

version: '3.8'

services:
  deploycat:
    image: meowsers/deploycat:latest
    container_name: deploycat
    restart: unless-stopped
    network_mode: host
    stop_grace_period: 40s
    devices:
      - /dev/net/tun:/dev/net/tun
    cap_add:
      - NET_ADMIN
    volumes:
      - /path/to/your/data:/data
      # Optional: second drive for game servers
      # - /path/to/drive2:/mnt/drive2
      # Optional: separate backup location
      # - /path/to/backups:/mnt/backupdrive
      # Optional: host Tailscale socket
      # - /var/run/tailscale:/var/run/tailscale
    environment:
      - PORT=8732
      - TZ=America/New_York
      - PUID=1000
      - PGID=1000
      # Optional: host Tailscale socket path
      # - TS_SOCKET=/var/run/tailscale/tailscaled.sock

Start with:

docker compose up -d

⁠Bridge Mode (Not Recommended) (like really....we don't recommend)

If you can't use host networking, use bridge mode and map ports manually. UPnP will NOT work. You must add a port mapping for every game server port you create.

docker run -d \
  --name deploycat \
  --restart unless-stopped \
  --stop-timeout 40 \
  --device /dev/net/tun \
  --cap-add NET_ADMIN \
  -p 8732:8732 \
  -p 25565-25575:25565-25575 \
  -p 19132:19132/udp \
  -p 7777:7777/udp \
  -p 7778:7778/udp \
  -p 8211:8211/udp \
  -p 27015:27015/udp \
  -p 27016:27016/udp \
  -p 16261:16261/udp \
  -p 16262:16262/udp \
  -p 8888:8888/tcp \
  -p 25575:25575/tcp \
  -v /path/to/your/data:/data \
  -e PORT=8732 \
  -e TZ=America/New_York \
  -e PUID=99 \
  -e PGID=100 \
  meowsers/deploycat:latest

⁠Unraid (we applied... give it time)

DeployCat is available in the Unraid Community Applications store. The template pre-configures all volume mappings, ports, and environment variables. Key settings:

• Network Type: Host
• Repository: meowsers/deploycat
• Data Location: /mnt/user/appdata/deploycat → /data
• PUID: 99 / PGID: 100
• Extra Parameters: --stop-timeout=40 --device=/dev/net/tun --cap-add=NET_ADMIN

⁠Hardware Requirements

Storage needs vary heavily by game — Minecraft needs ~2 GB, ARK needs ~alot of GB. The faster the IO the better.

⁠Troubleshooting

Web UI not loading?

• Make sure you're using http:// not https://
• Check that PORT (8732) is not blocked by a firewall
• If using bridge mode, make sure you mapped -p 8732:8732 (switch to host...)

Game servers not accessible from the internet?

• Use host networking mode — bridge mode blocks UPnP
• Check that your router supports UPnP and it's enabled
• Some ISPs block inbound connections (CGNAT) — contact your ISP

Permission errors on files?

• Make sure PUID and PGID match your host user
• Run id -u and id -g on your host to find the correct values
• On Unraid, use PUID=99 and PGID=100

Container keeps restarting?

• Check logs: docker logs deploycat
• Make sure /data is mounted to a writable location
• Make sure you have enough disk space (50+ GB recommended)

⁠Links and legal.

Proprietary software, all rights reserved No copying, modifying, distributing, or reverse engineering without written permission Subject to the EULA at deploycat.app/terms Requires a valid subscription to function

Free trial: Fully unlocked 3-day trial, no payment info required. After the trial, a paid subscription (monthly or annual) is required to continue.

You may NOT: resell, redistribute, reverse engineer, or offer DeployCat as a hosted service without written permission.

• Website: deploycat.app⁠
• Support: Join our discord https://discord.gg/gVcjQHfhUS⁠