Factory Bridge creates a secure connection between the Factory platform and your local machine, enabling powerful capabilities like running CLI commands, managing local processes, and accessing local resources directly from your Factory sessions.

​
System Requirements

Factory Bridge is available for MacOS and supported on most browsers except Safari and Brave.

​
Installation

1

Download Factory Bridge

Download the Factory Bridge from the “Connect to Machine” -> “Local Machine” menu in the top-right corner of a Factory session.
2

Install Factory Bridge

macOS
  • Open the downloaded .zip file
  • Drag Factory Bridge to your Applications folder

​
Getting Started

1

Launch Factory Bridge

If Factory Bridge isn’t already running, launch it from your applications menu or folder. Look for the Factory Bridge icon in your system tray or menu bar to confirm it’s running.
Factory Bridge runs in the background and manages its own window state. You can always access it by clicking on the tray icon.
2

Enter Pairing Code

When you first launch Factory Bridge, you’ll be prompted to enter a pairing code:
  1. Open Factory in your browser
  2. Navigate to a session where you want to use local capabilities
  3. Click on the CPU button in the top right of the session view, click “Local Machine”
  4. Factory will display a pairing code
  5. Enter this code in the Factory Bridge application
The pairing code ensures a secure connection between Factory and your local machine.
3

Confirm Connection

Once successfully paired:
  1. The Factory Bridge interface will display “Bridge Paired” with a green indicator
  2. Factory will show that Bridge is connected in the session
  3. You can now access local capabilities in your Factory session

​
Use Cases

​
Running Local CLI Commands

Factory Bridge allows you to execute local CLI commands directly from Factory sessions, making it easy to interact with your local development environment.

Execute Commands

Run commands on your local machine:
npm install react
python -m venv myenv
git status
Factory will display the command output in real-time.

Navigate Local Filesystem

Navigate and interact with your local filesystem:
ls -la
cd my-project
mkdir new-folder
Commands execute in your specified working directory.

​
Managing Local Processes

1

Start Processes

Launch local servers, build processes, or any long-running tasks:
npm start
python manage.py runserver
docker-compose up
2

Monitor Output

View real-time stdout and stderr output from the running process directly in Factory.
3

Interact with Processes

Send input to running processes as needed, such as responding to prompts or entering commands.
4

Terminate Processes

Easily stop processes when you’re done or need to restart them.

​
Development Workflow Integration

​
Troubleshooting

​
Security Considerations

Factory Bridge establishes a secure local connection between your machine and Factory. Here’s what you should know:
  • Bridge runs only on your local machine and doesn’t expose your system to the internet
  • All commands are executed with your user permissions only
  • The pairing code ensures only authorized Factory sessions can connect
  • You maintain full control over which processes are executed

Learn More About Factory Security

Explore Factory’s comprehensive security measures and compliance standards