Skip to content

Latest commit

 

History

History
86 lines (57 loc) · 2.22 KB

README.md

File metadata and controls

86 lines (57 loc) · 2.22 KB
Raw

🎮 Terraria Docker Server

Run your own Terraria server using Docker on Linux or Raspberry Pi! This project containerizes a Terraria server with TShock version 1.4.4.9.

📋 Table of Contents

✨ Features

  • 🐳 Easy deployment with Docker
  • 🍓 Supports both x86 and ARM64 (Raspberry Pi) architectures
  • 🛡️ Includes TShock for advanced server management
  • 🌍 Persistent world data with volume mapping

🧰 Prerequisites

  • Docker installed on your system
  • Basic knowledge of Docker and command-line operations

🚀 Installation

  1. Clone the repository:

    git clone https://github.com/surdle/terraria-docker.git
cd terraria-docker

  2. Build the Docker image:

    For x86 systems:

    docker build -t terraria-docker:latest .

    For ARM64 (Raspberry Pi):

    docker build -f arm64/dockerfile -t terraria-docker:latest .

🎮 Usage

  1. Run the Docker container:

    docker run -it -p 7777:7777 -v /home/$USER/terraria:/data --name terraria-docker terraria-docker

  2. Connect to your server in Terraria using your server's IP address and port 7777.

⚙️ Configuration

  • The server configuration file is located at /data/serverconfig.txt inside the container.
  • World files are stored in the /data directory.
  • Modify these files to customize your server settings.

🔌 Ports

  • 7777 - Default Terraria server port (TCP)

📂 Volumes

  • /data - Contains world files, configuration, and logs

🛠️ Troubleshooting

  • If you encounter permission issues, ensure the /home/$USER/terraria directory has the correct permissions.
  • For networking issues, check your firewall settings and ensure port 7777 is open.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is open source and available under the MIT License.

Happy crafting and exploring! If you find this project helpful, please give it a ⭐️ on GitHub!