OpenFlexure Management Server

A server that run on an OpenFlexure Microscope to manage the microscope.

This server is just starting to be written so doesn't yet do much. Currently it is able to:

• Report the microscope server and service status
• Shut down or restart the microscope
• Shut down or restart the server

Eventually it will be able to:

• Configure the server for different hardware
• Install microscope extensions
• Update the microscope

Installation

This is experimental. When it moves out of the experiment phase it will automatically be installed on microscpe SD images. It only works on the new Trixie images.

For now to install a test version on a microscope for developing:

1. Run ofm activate
2. Clone the repository
3. Navigate into the repo and run npm install -e .[dev]
4. Create a systemd service file that mirrors the one used by the microscope (/etc/systemd/system/openflexure-microscope-server.service) replacing openflexure-microscope-server to openflexure-management-server.
5. Run sudo systemctl enable openflexure-management-server

Developing on a Microscope

Developing the webapp

Use Node 24. If you donlt have node 24, consider using NVM to manage node versions on your computer.

To install, navigate to the webapp directory and run:

npm install

Running the dev server

To run the dev server run:

npm run serve

The server will update the API endpoints by default to http://localhost:5001. To Redirect to a microscope run:

npm run serve:microscope

This will update the API endpoints to point at http://microscope.local:5001. To use a different host name use an .env.local file with your hostname set to VITE_MICROSCPOPE_HOST:

# Save as .env.local
VITE_MICROSCPOPE_HOST=http://hostname.local:5001

This .env.local file is ignored by git.