Skip to content

Connecting to Revit

Connection settings

Each .blend file stores its own connection settings, independent of the global preferences. To configure them, click the gear icon (⚙) in the Connection panel.

Screenshot needed: Server settings dialog

Setting Default Description
Host 127.0.0.1 Hostname or IP address to listen on
Port 3000 Port to listen on
Auto Start On Start the server automatically when the file loads
Timeout 3.0s How long to wait for the server to start or stop (max 30s)

For a standard local setup — Revit and Blender on the same machine — the defaults work without any changes.


Starting and stopping the server

The Connection panel shows the current server state:

  • Server is stopped… — click to start the server
  • Running on host:port — click to stop the server

The panel updates in real time as the state changes. Stopping the server disconnects the Revit client — documents already in the scene are preserved, so you won't lose your work.

Screenshot needed: Connection panel — stopped state and running state


Auto Start

With Auto Start enabled, reopening the file or reloading the add-on picks up where you left off — the server resumes and your documents remain available. If the add-on detects a listener already running on the configured port, it adopts it rather than starting a new one.

Once the server is running, send a sync from Blendersync for Revit. The first document will appear in the Links panel.