🏎️ Assetto Server Manager v1.7.12 - Complete English Guide

🌍 Languages / Idiomas

🇺🇸 English: You are reading it now
🇪🇸 Español: README-ES.md

📋 Table of Contents

🚀 Introduction
💻 Installation
🔧 Configuration
🏁 Basic Usage
⚙️ Advanced Features
🔧 Compilation
🐛 Troubleshooting
📖 References

🚀 Introduction

Assetto Server Manager is a comprehensive web interface to manage an Assetto Corsa Server.

This is a fork maintained by RodrigoAngeloni, based on the excellent work of the original authors.

✨ What's New in v1.7.12

🎨 Custom icon in Windows executables
🧹 Automatic cleanup system for temporary files
📁 Improved organization of binaries in specific folders
🔄 Optimized build process with better resource handling
🛠️ Automatic installation of development tools
📊 Version information embedded in executables

🎯 Features

Quick Race Mode - Start racing instantly
Custom Race Mode with saved presets for your favorite configurations
Live Timings for current sessions with real-time updates
Results pages for all previous sessions, with the ability to apply penalties
Content Management - Upload tracks, weather and cars easily
Sol Integration - Sol weather is compatible, including 24 hour time cycles
Championship mode - configure multiple race events and keep track of driver, class and team points
Race Weekends - a group of sequential sessions that can be run at any time
Integration with Assetto Corsa Skill Ratings!
Automatic event looping for continuous racing
Server Logs / Options Editing with real-time monitoring
Accounts system with different permissions levels
Linux and Windows Support with optimized builds for both platforms

If you like Assetto Server Manager, please consider supporting us with a donation!

🔒 Security & Modernization (v1.7.12)

This project has been completely modernized with significant security and performance improvements:

✅ Latest Updates (v1.7.12):

Go Runtime: Updated to Go 1.22.0 (from 1.13) - 9 major versions ahead
npm Vulnerabilities: Reduced from 45 to 1 (98% improvement)
Router Modernization: Upgraded to Chi v5 for better performance
Security Packages: Updated all cryptographic and networking libraries to 2024 versions
Dependencies: Modernized jQuery, Bootstrap, Moment.js, and 50+ other core libraries
Build System: Eliminated all Sass deprecation warnings, modernized gulp ecosystem
Icon Integration: Custom Windows executable icons with automated resource compilation
Build Organization: Streamlined build process with automatic cleanup and organization

🛡️ Security Fixes:

Critical CVE Fixes: Addressed vulnerabilities in frontend dependencies
Go Security Updates:
- golang.org/x/crypto → v0.28.0 (2024)
- golang.org/x/net → v0.30.0 (2024)
- golang.org/x/sync → v0.8.0 (2024)
WebSocket & Logging: Updated gorilla/websocket and sirupsen/logrus
Import Path Corrections: Fixed all deprecated bbolt import paths

🚀 Performance Improvements:

Chi Router v5: Better routing performance and modern API
Updated Build Tools: Faster compilation with modern Sass, Gulp 5.0, TypeScript
Optimized Dependencies: Removed unused packages, updated to latest stable versions

📊 Modernization Results:

✅ Go 1.13 → 1.22.0 (latest stable)
✅ 98% reduction in npm vulnerabilities (45→1)  
✅ All critical security packages updated to 2024
✅ Zero deprecation warnings in build process
✅ Router performance improved with Chi v5
✅ Build time optimizations achieved
✅ Custom Windows icons with automated embedding
✅ Organized build artifacts in proper directory structure

💻 Installation

📋 Prerequisites

🖥️ Windows

Go 1.22.0 or higher
Node.js 16.0 or higher
npm 8.0 or higher
Make (via Chocolatey: choco install make)
Git for version control

🐧 Linux

# Ubuntu/Debian
sudo apt update
sudo apt install golang-go nodejs npm make git

# CentOS/RHEL
sudo yum install golang nodejs npm make git

🚀 Quick Installation

📥 Option 1: Download Pre-compiled Release

Go to the Releases page
Download server-manager-v1.7.12-windows.zip or server-manager-v1.7.12-linux.tar.gz
Extract the file to your preferred directory
Edit the config.yml to suit your preferences
Either:
- Copy the server folder from your Assetto Corsa install into the directory you configured in config.yml, or
- Make sure that you have steamcmd installed and in your $PATH and have configured the steam username and password in the config.yml file.
Start the server using ./server-manager (on Linux) or by running server-manager.exe (on Windows)

🌐 Access: http://localhost:8772

👤 Default credentials:

Username: admin
Password: changeme (⚠️ Change it immediately!)

📦 Option 2: Clone and Build from Source

git clone https://github.com/JustaPenguin/assetto-server-manager.git
cd assetto-server-manager

Windows:

.\build.ps1

Linux:

chmod +x build.sh
./build.sh

🏁 Basic Usage

🏃‍♂️ Create Your First Race

🖱️ Navigate to "Custom Races"
🏎️ Select:
- Track 🏁
- Cars 🚗
- Number of participants 👥
⚙️ Configure:
- Session duration ⏱️
- Weather conditions 🌤️
- Server settings 🔧
🚀 Start the race

🏆 Championship Management

📝 Create Championship

Go to "Championships" → "New Championship"
Configure:
- 📛 Championship name
- 📝 Description
- 🎯 Points system
- 👥 Participants

📅 Schedule Events

⏰ Flexible scheduling with multiple time zones
🔄 Recurring events (weekly, monthly)
📧 Automatic notifications for participants

⚙️ Advanced Features

🤖 Integrations

📊 sTracker

stracker:
  enabled: true
  http_config:
    listen_port: 50041

🎮 Discord Bot

discord:
  token: "your_discord_token"
  channel_id: "channel_id"

🏁 Real Penalty Tool

⚖️ Automatic penalty system
📋 Customizable rule configuration
📊 Detailed infringement reports

🔐 Security and Users

👥 User Management

🔑 Differentiated roles: Admin, Write, Read, Delete
🔒 Steam authentication (optional)
🛡️ Secure passwords with configurable policies

🔐 HTTPS Configuration

tls:
  enabled: true
  cert_file: "/path/to/cert.pem"
  key_file: "/path/to/key.pem"

📊 Monitoring and Logs

📈 Live Timings

⏱️ Real-time timing during races
🗺️ Real-time map of positions
💬 Integrated chat with moderation
📱 Mobile-optimized interface

📋 Auditing

📝 Detailed logs of all actions
👤 User tracking and changes
📊 Server usage reports

🔧 Compilation

🛠️ Build System v1.7.12

The new system includes:

✨ Build Script Features

🧹 Automatic cleanup at start and finish
🎨 Automatic icon embedding
📁 Smart binary organization
🔄 Resource regeneration on each build
📊 Automatic version information

🚀 Build Process

# The build.ps1 script automatically performs:

# 🧹 Step 0: Initial cleanup
# 📦 Step 1: Go dependencies installation
# 🎨 Step 2: Frontend compilation
# 📁 Step 3: Asset embedding
# 🎯 Step 4a: Resource compilation (icon)
# 🖥️ Step 4b: Application compilation
# 📋 Step 5: Post-compilation configuration
# 📦 Step 6: Release creation and final cleanup

📂 Output Structure

cmd/server-manager/build/
├── 🖥️ windows/
│   ├── server-manager.exe  # With embedded icon
│   └── config.yml
├── 🐧 linux/
│   ├── server-manager
│   └── config.yml
└── 📚 documentation...

🎨 Icon Customization

To change the icon:

Replace cmd/server-manager/static/img/servermanager.ico
Run .\build.ps1 - the new icon will be applied automatically

🔨 Manual Build Steps

If you prefer to build manually:

Windows:

# Use the modernized build script
.\build.ps1

Linux/macOS:

# Use the build script
chmod +x build.sh
./build.sh

📋 Manual Build Steps

Install Dependencies:

go mod tidy
go install github.com/mjibson/esc@latest

Build Frontend:

cd cmd/server-manager/typescript
npm install --legacy-peer-deps
npx gulp build

Embed Assets & Build:

cd ../
make asset-embed
go build -o server-manager

🐛 Troubleshooting

❗ Common Issues

🚫 "Error: Go is not installed"

# Install Go from https://golang.org/dl/
# Verify installation:
go version

🚫 "Error: Make is not available"

# Windows - install with Chocolatey:
choco install make

# Or use scoop:
scoop install make

🚫 "Frontend compilation error"

# Clear npm cache:
cd cmd\server-manager\typescript
npm cache clean --force
npm install --legacy-peer-deps

🚫 "Port 8772 already in use"

# Change port in config.yml:
port: 8773  # Or any free port

🔍 Logs and Debugging

📋 Log Locations

Windows: cmd\server-manager\logs\
Linux: cmd/server-manager/logs/

🐛 Debug Mode

# config.yml
log_level: "debug"

📊 Performance Monitoring

monitoring:
  enabled: true
  metrics_port: 8773

🔧 Maintenance

🗄️ Data Backup

# Automatic backup of important data:
xcopy "cmd\server-manager\*.db" "backup\" /Y
xcopy "cmd\server-manager\config.yml" "backup\" /Y

🔄 Updates

Backup config.yml and data files
Download new version
Replace binaries while maintaining configuration
Verify functionality

🐳 Docker

A docker image is available under the name seejy/assetto-server-manager. We recommend using docker-compose to set up a docker environment for the server manager. This docker image has steamcmd pre-installed.

Note: if you are using a directory volume for the server install (as is shown below), be sure to make the directory before running docker-compose up - otherwise its permissions may be incorrect.

You will need a config.yml file to mount into the docker container.

An example docker-compose.yml looks like this:

version: "3"

services:
  server-manager:
    image: seejy/assetto-server-manager:latest
    ports:
    # the port that the server manager runs on
    - "8772:8772"
    # the port that the assetto server runs on (may vary depending on your configuration inside server manager)
    - "9600:9600"
    - "9600:9600/udp"
    # the port that the assetto server HTTP API runs on.
    - "8081:8081"
    # you may also wish to bind your configured UDP plugin ports here. 
    volumes: 
    # volume mount the entire server install so that 
    # content etc persists across restarts
    - ./server-install:/home/assetto/server-manager/assetto
    
    # volume mount the config
    - ./config.yml:/home/assetto/server-manager/config.yml

Post Installation

We recommend uploading your entire Assetto Corsa content/tracks folder to get the full features of Server Manager. This includes things like track images, all the correct layouts and any mod tracks you may have installed.

Also, we recommend installing Sol locally and uploading your Sol weather files to Server Manager as well so you can try out Day/Night cycles and cool weather!

Updating

Follow the steps below to update Server Manager:

Back up your current Server Manager database and config.yml.
Download the latest version of Server Manager
Extract the zip file.
Open the Changelog, read the entries between your current version and the new version. There may be configuration changes that you need to make!
Make any necessary configuration changes.
Find the Server Manager executable for your operating system. Replace your current Server Manager executable with it.
Start the new Server Manager executable.

Build From Source Process

📋 For a detailed step-by-step guide, see BUILD_GUIDE.md

Prerequisites

Required Software:

Go 1.20+ ⚠️ REQUIRED (tested with Go 1.22.0) - Download here
Node.js 18+ (tested with Node.js 22.x) - Download here
Make (build tool)
Git (version control)

Quick Build (Automated)