https://github.com/ketbome/hytale-server
Docker image for Hytale dedicated server with web panel. Easy setup, auto-download, real-time console.
https://github.com/ketbome/hytale-server
dedicated-server game-server gaming hypixel hytale hytale-server java minecraft server-management web-panel
Last synced: 5 months ago
JSON representation
Docker image for Hytale dedicated server with web panel. Easy setup, auto-download, real-time console.
- Host: GitHub
- URL: https://github.com/ketbome/hytale-server
- Owner: Ketbome
- License: other
- Created: 2026-01-15T18:53:42.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-18T23:16:26.000Z (5 months ago)
- Last Synced: 2026-01-19T12:10:55.802Z (5 months ago)
- Topics: dedicated-server, game-server, gaming, hypixel, hytale, hytale-server, java, minecraft, server-management, web-panel
- Language: JavaScript
- Homepage:
- Size: 350 KB
- Stars: 8
- Watchers: 0
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Hytale Dedicated Server - Docker
Docker image for Hytale dedicated server with web panel, auto-download, and JWT authentication.
## Quick Start
```bash
# 1. Create folder
mkdir hytale && cd hytale
# 2. Download files
curl -O https://raw.githubusercontent.com/ketbome/hytale-server/main/docker-compose.yml
curl -O https://raw.githubusercontent.com/ketbome/hytale-server/main/.env.example
# 3. Configure
cp .env.example .env
nano .env # Change PANEL_USER and PANEL_PASS!
# 4. Start
docker compose up -d
# 5. Open panel
# http://localhost:3000
```
## Authentication
The panel requires login. Default credentials:
- **User**: `admin`
- **Pass**: `changeme`
⚠️ **Change these in your `.env` file before deploying!**
```env
PANEL_USER=your_username
PANEL_PASS=your_secure_password
```
## Configuration
Copy `.env.example` to `.env` and edit:
```env
# Server
JAVA_XMS=4G
JAVA_XMX=8G
BIND_PORT=5520
# Panel Auth
PANEL_USER=admin
PANEL_PASS=changeme
JWT_SECRET=optional-random-string
```
### All Variables
| Variable | Default | Description |
|----------|---------|-------------|
| `JAVA_XMS` | `4G` | Minimum RAM |
| `JAVA_XMX` | `8G` | Maximum RAM |
| `BIND_PORT` | `5520` | Game UDP port |
| `AUTO_DOWNLOAD` | `true` | Auto-download game |
| `PANEL_USER` | `admin` | Panel username |
| `PANEL_PASS` | `changeme` | Panel password |
| `PANEL_PORT` | `3000` | Panel HTTP port |
### RAM Guide
| Players | JAVA_XMX |
|---------|----------|
| 1-10 | 4G |
| 10-20 | 6G |
| 20-50 | 8G |
| 50+ | 12G+ |
## Web Panel Features
- 📜 Real-time console logs
- ⌨️ Send server commands
- 🔐 JWT authentication
- 📁 File manager (upload, edit, delete)
- 🌍 Multi-language (EN/ES/UK)
- 📊 Server status & uptime
## Manual Download
If auto-download fails, get files from https://hytale.com and place in `./server/`:
- `HytaleServer.jar`
- `Assets.zip`
## Commands
```bash
# View logs
docker compose logs -f
# Stop
docker compose down
# Update
docker compose pull && docker compose up -d
# Backup
docker compose stop
tar -czvf backup.tar.gz server/
docker compose start
```
## Firewall
```bash
# Linux
ufw allow 5520/udp
# Windows
New-NetFirewallRule -DisplayName "Hytale" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow
```
## Ports
| Service | Port |
|---------|------|
| Game | 5520/UDP |
| Panel | 3000/TCP |
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md)
## License
**Free for personal and non-commercial use.**
Commercial use by companies with >$100k revenue requires permission. See [LICENSE](LICENSE).
---
*This project is not affiliated with Hypixel Studios or Hytale.*