Skip to content

Add FiveM server template with dual deployment modes#393

Merged
Siumauricio merged 5 commits intoDokploy:mainfrom
shishirahm3d:feat/add-fivem-server
Sep 27, 2025
Merged

Add FiveM server template with dual deployment modes#393
Siumauricio merged 5 commits intoDokploy:mainfrom
shishirahm3d:feat/add-fivem-server

Conversation

@shishirahm3d
Copy link
Contributor

📝 Description

Adds a new FiveM template to the Dokploy templates repository. FiveM is a popular modded GTA V multiplayer server platform with two distinct deployment approaches.

✨ What's Added

  • Docker Compose Configuration: Uses spritsail/fivem image with proper TTY setup
  • Dual Deployment Modes: Support for both standard server and txAdmin web interface
  • Comprehensive Documentation: Clear instructions for each deployment mode
  • Template Configuration: Complete template.toml with environment variable descriptions
  • Branding: FiveM logo and proper meta.json entry

🎮 Features

  • Standard FiveM Server: Direct deployment with license key environment variable
  • txAdmin Web Interface: Web-based server management and configuration
  • HTTPS Support: Automatic SSL through Dokploy for web interface
  • Persistent Storage: Volumes for server config and txAdmin data
  • Proper Port Mapping: Game server (30120) and web UI (40120) ports
  • Interactive Setup: TTY and stdin_open for container requirements

🔧 Deployment Modes

Mode 1: Standard Server

  • Set LICENSE_KEY environment variable
  • Direct server deployment
  • Configuration via mounted files

Mode 2: txAdmin Web Interface

  • Set NO_DEFAULT_CONFIG=1
  • License configured via web UI
  • Web-based server management

📋 Files Added

  • blueprints/fivem/docker-compose.yml - Main service configuration with mode documentation
  • blueprints/fivem/template.toml - Dokploy template with optional environment variables
  • blueprints/fivem/README.md - Comprehensive setup guide for both modes
  • blueprints/fivem/logo.svg - FiveM template logo
  • meta.json - Added template metadata entry

🧪 Testing

  • Docker Compose syntax validated
  • Template.toml follows Dokploy standards
  • Meta.json entry properly formatted
  • Both deployment modes documented
  • Environment variable conflicts addressed

🚨 Key Design Decisions

  • Dual Mode Support: Addresses the different ways users deploy FiveM servers
  • Clear Documentation: Prevents common licensing configuration errors
  • Optional License Key: Accommodates txAdmin's web-based license setup
  • Comprehensive Warnings: Prevents mixing deployment modes

📚 Related Links

🏷️ Tags

gaming, gta, multiplayer, server

feat: add FiveM server template with dual deployment modes

- Add docker-compose.yml with spritsail/fivem image
- Support both standard FiveM server and txAdmin web interface modes
- Configure environment variables for license key management
- Add comprehensive documentation for deployment modes
- Include template.toml with optional license key configuration
- Add FiveM logo and meta.json entry
- Support persistent storage for config and txAdmin data
- Configure proper port mapping (30120 game, 40120 web UI)
- Add interactive TTY setup required for FiveM container

Template supports two modes:
- Standard: Direct server with LICENSE_KEY env var
- txAdmin: Web management with NO_DEFAULT_CONFIG=1
docs: clarify FiveM deployment modes in docker-compose

Add detailed comments explaining standard server vs txAdmin modes
to prevent configuration errors and licensing issues.
@github-actions
Copy link

github-actions bot commented Sep 23, 2025

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name Status Preview Last Commit
templates ✅ Ready (View Log) Visit Preview 7bcba7f

@Harikrishnan1367709
Copy link
Contributor

Approved
Screenshot 2025-09-24 at 12 07 43 PM

Comment on lines +6 to +13
{ name = "LICENSE_KEY", description = "FiveM server license key (obtain free from https://forum.fivem.net/) - ONLY for standard mode, leave empty if using txAdmin", required = false },
{ name = "RCON_PASSWORD", description = "RCON password for server management (optional - random 16 char password assigned if not specified)", required = false },
{ name = "NO_DEFAULT_CONFIG", description = "Set to '1' to enable txAdmin web interface (license configured via web UI), leave empty for standard FiveM server (requires LICENSE_KEY)", required = false },
{ name = "NO_LICENSE_KEY", description = "Set to '1' to disable license key in environment (useful if license is in config file)", required = false },
{ name = "NO_ONESYNC", description = "Set to '1' to disable OneSync being added to default configs", required = false }
]
mounts = []

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Siumauricio Done. I've fixed the template.toml format.

@Siumauricio Siumauricio merged commit eaf5fd5 into Dokploy:main Sep 27, 2025
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants