jnonymous420/hlds3111e repository overview

⁠Create the Docker Hub Overview text content with proper formatting

⁠overview_text = """
HLDS 3111e - Counter-Strike 1.6 Dedicated Server

This Docker image runs a Counter-Strike 1.6 HLDS (Build 3111e) server inside a container.

⁠🛠 Repository Links

GitHub: https://github.com/kuyajnonymous/hlds3111e⁠ Docker Hub: https://hub.docker.com/r/jnonymous420/hlds3111e⁠

⁠🚀 Quick Start

Run with 'docker run' command:

docker run -d --name hlds_server \\
  -p 27015:27015/tcp -p 27015:27015/udp \\
  jnonymous420/hlds3111e \\
  ./hlds_run +ip 0.0.0.0 +port 27015 -game cstrike +map de_dust \\
  +maxplayers 16 -noauth -insecure +sv_lan 1

✅ What this does:

• Starts a CS 1.6 HLDS server in detached mode (-d).
• Exposes port 27015 for both TCP & UDP.
• Runs HLDS with default settings (de_dust, 16 players, LAN mode, etc.).

⁠🛠 Docker Compose Setup

If you want to manage the server with Docker Compose, use this configuration:

version: '3.8'

services:
  hlds_server:
    image: jnonymous420/hlds3111e
    container_name: hlds3111e
    restart: unless-stopped
    user: "0:0"  # Running as root (consider using a non-root user for security)
    tty: true
    stdin_open: true
    # volumes:
    #   - /opt/cstrike:/server/hlds_l/cstrike # Uncomment to mount a custom cstrike folder
    ports:
      - "27015:27015/tcp"
      - "27015:27015/udp"
    command: >
      ./hlds_run +ip 0.0.0.0 +port 27015 -game cstrike +map de_dust
      +maxplayers 16 -noauth -insecure +sv_lan 1
    security_opt:
      - no-new-privileges:1

To run the server:

docker-compose up -d

This will start the HLDS server and automatically restart it if it crashes.

⁠⚙️ Configuration Options

You can modify HLDS settings by passing arguments to 'hlds_run'.

To customize settings, change the command in 'docker-compose.yml' or 'docker run'.

⁠📂 Persistent Data (Mounting cstrike)

To keep server data (maps, configs, etc.), mount a local directory:

docker run -d --name hlds_server \\
  -p 27015:27015/tcp -p 27015:27015/udp \\
  -v /opt/cstrike:/server/hlds_l/cstrike \\
  jnonymous420/hlds3111e \\
  ./hlds_run +ip 0.0.0.0 +port 27015 -game cstrike +map de_dust \\
  +maxplayers 16 -noauth -insecure +sv_lan 1

🔹 This ensures 'cstrike' files persist after container restarts.

⁠💡 Notes & Recommendations

• Make sure ports 27015 (TCP & UDP) are open on your firewall.
• Use '+sv_lan 0' for public servers (instead of '+sv_lan 1').
• Consider using a non-root user ('user: "1000:1000"') for better security.
• If running on a low-memory VPS, tweak the server settings to optimize performance.

⁠🐞 Troubleshooting

Check server logs:

docker logs -f hlds_server

Restart the container:

docker restart hlds_server

Stop the container:

docker stop hlds_server

⁠📜 License

This project follows the Valve Software EULA. Use at your own risk.