GitHub Get Started

Download GOTRS

Get started with GOTRS - download the latest release or run it with Docker/Podman.

Download GOTRS

Get started with GOTRS today. Choose from multiple deployment options to fit your infrastructure.

Quick Start with Docker/Podman

The fastest way to try GOTRS is with containers:

# Clone the repository
git clone https://github.com/gotrs-io/gotrs-ce.git
cd gotrs-ce

# Set up environment variables (REQUIRED!)
cp .env.development .env    # For local development
# OR for production:
cp .env.example .env        # Then edit ALL values before use

# Start all services (auto-detects docker/podman compose command)
make up

# Alternative methods:
./scripts/compose.sh up          # Auto-detect wrapper script
docker compose up        # Modern Docker
docker-compose up        # Legacy Docker
podman compose up        # Podman plugin
podman-compose up        # Podman standalone

Access GOTRS at http://localhost

Admin Login:

  • Username: root@localhost
  • Password: generated via make synthesize (or set manually with make reset-password)

⚠️ Security Note: GOTRS does not ship with a default password—always generate or reset credentials before use.

Container Images

Pre-built container images are available on GitHub Container Registry:

# Main application (goats binary)
podman pull ghcr.io/gotrs-io/gotrs-ce:latest

# Development toolbox
podman pull ghcr.io/gotrs-io/gotrs-ce-toolbox:latest

# Test runner
podman pull ghcr.io/gotrs-io/gotrs-ce-tests:latest

Source Code

Build from source for development or customization:

# Clone repository
git clone https://github.com/gotrs-io/gotrs-ce.git
cd gotrs-ce

# Install dependencies
go mod download

# Run in development mode
make up

# Development workflow
make up-d          # Start in background
make backend-logs  # View logs
make down          # Stop services
make clean         # Reset everything

System Requirements

Minimum Requirements (Development/Small Business)

  • CPU: 2 cores
  • RAM: 4GB
  • Storage: 20GB
  • OS: Linux, macOS, or Windows with WSL2
  • Database: PostgreSQL 14+ or MySQL 8+
  • CPU: 8+ cores
  • RAM: 16+ GB
  • Storage: 100+ GB SSD
  • OS: Linux (RHEL, Ubuntu, or similar)
  • Database: PostgreSQL 14+ cluster or MySQL 8+ cluster

Supported Platforms

  • Container Runtime: Docker 20.10+, Podman 3.0+
  • Orchestration: Kubernetes 1.24+, OpenShift 4.10+
  • Databases: PostgreSQL 14+, MySQL 8+
  • Cache: Valkey 7+ (Redis-compatible)
  • Search: Zinc (Elasticsearch-compatible)
  • Architectures: amd64, arm64

Architecture Highlights

  • Binary: Single goats binary (44.7MB) runs everything
  • Frontend: HTMX + Alpine.js + Tailwind CSS
  • Backend: Go 1.23 with Gin framework
  • Template Engine: Pongo2 (Django-like syntax)
  • Database: Dual support for PostgreSQL and MySQL
  • Container: Multi-stage builds with BuildKit optimization

Installation Guides

Choose your deployment method:

Next Steps

  1. Getting Started Guide - Get up and running in 5 minutes
  2. Configuration Guide - Configure GOTRS for your organization
  3. Migration Guide - Migrate from OTRS or other systems
  4. API Documentation - Integrate with existing tools

Support

License: GOTRS is licensed under Apache License 2.0