Configuring Worker

After installing Worker, you need to configure it to work with Aura. The most important setting is your working directory - the folder where Worker reads input files and saves output.

Setting the Working Directory

The working directory is a local folder on your computer where:

• Input files are read from (point clouds, data files)
• Output files are saved (processed data, exports)
• Temporary files are stored during processing

/Users/username/Documents/AuraProjects
/home/username/aura-data

C:\Users\username\Documents\AuraProjects
D:\AuraData

Recommended Working Directory Structure

Organize your working directory for easy file management:

AuraProjects/
├── project-1/
│   ├── input/
│   │   └── raw-data.laz
│   ├── output/
│   │   └── processed.laz
│   └── exports/
├── project-2/
│   ├── input/
│   ├── output/
│   └── exports/
└── tilesets/
    └── tileset.json

Connection Settings

Default Port

Worker runs on port 8000 by default. If you need to change this:

1. Set the FASTAPI_PORT environment variable before starting Worker
2. Update the port in Aura's settings to match

Aura Settings

In Aura, you can configure the Worker connection:

1. Go to Settings from the user menu
2. Find FastAPI Port setting
3. Enter the port Worker is running on (default: 8000)

Verifying the Connection

Check Worker Status

In Aura's left sidebar, look for the Worker status indicator:

• 🟢 Green dot - Worker is connected and ready
• 🔴 Red pulsing dot - Worker is not connected

Test the Connection

To verify Worker is working:

1. Open a Digital Grid tool (like Add Pole)
2. Try to place a pole on the map
3. If Worker is connected, the operation will proceed
4. If not connected, you'll see an error message

Working Directory Persistence

Your working directory setting is saved in two places:

In Aura (Browser)

• Stored in browser localStorage
• Persists across sessions
• Specific to the browser you're using

In Worker

• Stored in a state file: {temp_dir}/qs_worker_working_dir.state
• Used to resolve relative file paths
• Cleared when Worker restarts (re-validated from Aura)

File Access

Worker needs access to read and write files in your working directory:

Permissions Required

• Read access - To load input files
• Write access - To save output files
• Execute access (directories) - To list and traverse folders

Common Permission Issues

macOS:

• Grant "Full Disk Access" if needed (System Preferences → Security & Privacy → Privacy)
• Allow access when prompted by the system

Windows:

• Run Worker as the same user who owns the directory
• Avoid system-protected directories

Linux:

• Ensure your user owns the directory or has proper permissions
• Check with ls -la to verify permissions

Multiple Working Directories

If you work with multiple projects in different locations:

1. Change the working directory when switching projects
2. Re-validate after changing directories
3. Worker will use the most recently validated directory

Environment Variables

Worker supports these environment variables:

Set these before starting Worker if needed.

Next Steps

After configuring Worker:

1. Verify your connection if you encounter issues
2. Start using Digital Grid tools
3. Learn about distance calculations