Skip to content
Trailer.devDocumentation

Search is only available in production builds. Try building and previewing the site to test it out locally.

Release notes: v1.0.0

Trailer.dev is a self-hostable platform that enables seamless container-based development environments.
It provides a modern, efficient way to manage development workspaces and container resources.
Trailer.dev puts emphasis on Python and ML development for ease-of-use.

This is the first stable release of Trailer.dev. It is a large release that brings Windows virtual desktops, GPU support, full resource monitoring, and a long list of platform improvements.

New Features

Section titled “New Features”

Windows and Linux virtual desktops (VDI)

Section titled “Windows and Linux virtual desktops (VDI)”

Trailer can now run full graphical desktops as workspaces.

  • Windows VDI: Boot a real Windows VM (Windows 10/11 and Server 2022/2025) inside a workspace, accessible from the browser. Builds are personalized per image: the admin username, password, keyboard layout, region, and uploaded files are injected without re-running the multi-hour Windows install. First-boot setup runs at build time so recreated workspaces go straight to the logon screen.
  • Linux VDI: Webtop-based Linux desktops with selectable desktop environments and one-click VDI apps.
  • Files can be uploaded and placed at chosen paths inside the desktop image.
  • Volumes are exposed to Windows desktops as drives, and exposed ports are automatically forwarded into the VM.

GPU support

Section titled “GPU support”
  • GPU passthrough: Attach host GPUs to workspaces, including to Windows VDI workspaces.
  • Driver management: Agents can deploy the NVIDIA driver and container toolkit separately, and bind or reset GPU drivers as needed.
  • Detection: GPUs are detected from their sysfs entries, so detection no longer depends on the NVIDIA driver being present first.
  • Metrics: GPU utilization, temperature, and power draw are collected and charted when the driver is deployed.
  • Each GPU selector shows which workspaces are currently using the device.

Resource monitoring

Section titled “Resource monitoring”
  • New resource monitor for hosts, workspaces, and GPUs.
  • Charts for CPU, memory, network, and GPU metrics with selectable time ranges (including 48 hour, 1 week, and custom ranges), full-screen popups, and downsampling.
  • Per-host metrics retention duration is configurable.
  • Workspace resource usage is shown directly on the workspaces list.

Services

Section titled “Services”
  • A new Services concept lets images declare startup services and VDI desktops.
  • Multi-service images are supported through a supervised init system.

Networking

Section titled “Networking”
  • Macvlan networks: Create macvlan networks for the Docker agent, including for Windows VDI workspaces.
  • Port publishing now works on workspaces whose host IP overlaps a macvlan network.
  • Host network interfaces are detected and listed.
  • Port mappings can carry an optional description.

Workspaces

Section titled “Workspaces”
  • Snapshotting: Capture and restore workspace snapshots.
  • Clone: Clone existing images and workspaces.
  • Hardware acceleration, nested virtualization, and a configurable init system can be enabled per workspace.
  • Workspaces can be created directly from OCI images.

Notifications

Section titled “Notifications”
  • In-app notifications for important events, with debounced alerts for unstable workspaces.

User management and authentication

Section titled “User management and authentication”
  • Admins can invite users by email, with an accept-invite flow.
  • GitHub and generic OIDC OAuth providers are supported for login.
  • Admins can enable or disable users and delete hosts.
  • A new login screen consistent with the Trailer.dev SaaS experience.

Images

Section titled “Images”
  • Final image squashing is now an option per image.
  • Local and WASM-backed package recommendations during image creation.
  • Platform badges in the Python package search.

Terminal and UI

Section titled “Terminal and UI”
  • The in-browser terminal now uses Ghostty.
  • Realtime subscriptions on resource list and detail pages.
  • Status badges and detailed tooltips across resource tables.
  • Collapsible sidebar and action columns, an OS-aware (auto) theme option, and improved mobile layouts.

Agent

Section titled “Agent”
  • Agents register their capabilities with the server, so the UI hides actions a host cannot perform.
  • Agent logs can be viewed through the server.
  • Agent version is shown on the host detail screen.
  • Resources created by the agent are scoped to Trailer.

Server and operations

Section titled “Server and operations”
  • SMTP settings are configurable from the settings screen.
  • Cryptographic signing for the SaaS server image.
  • Faster, more direct image build pipeline.

Fixes

Section titled “Fixes”
  • Use /32 host-route exceptions instead of flushing the macvlan route, fixing connectivity on macvlan networks.
  • Workspaces no longer recreate when anonymous volumes are present
  • Fixed a race condition between the log reader and volume reconciliation.
  • Corrected GPU power usage reporting on newer NVIDIA drivers.
  • Image push, pull, and base-image registry authentication fixes; registry credentials are no longer exposed.
  • Logs now work for stopped workspaces.
  • Workspace connection requests are bound to the user so they cannot be hijacked.
  • Only enabled images can be used to create workspaces; redeploy, exec, and attach are gated behind the “can modify” permission.
  • Numerous Windows host fixes (OS version detection, memory usage reporting).

Limitations

Section titled “Limitations”
  • The Trailer agent only supports Docker based environments as of v1.0.0
  • The Community version of the server only supports one registered agent per server without a license key. For a license key, subscribe on Trailer.dev Cloud