🎮 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
• Prerequisites
• Installation
• Usage
• Configuration
• Troubleshooting
• Contributing
• License

✨ 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!