Installation

Set up CryoProcess on your Linux server in minutes.

System Requirements

Minimum specifications for running CryoProcess alongside RELION.

Requirement	Minimum	Recommended
OS	Ubuntu 20.04+, Debian 11+, RHEL 8+	Ubuntu 22.04+
Node.js	18+	20+ (auto-installed)
MongoDB	6.0+	8.0 (auto-installed)
SLURM	Any recent version
RELION	Singularity .sif container	5.0
GPU	NVIDIA with CUDA (for RELION)
Conda	Only for --conda mode	mamba (faster)

CryoProcess itself is lightweight — the RAM and GPU requirements are for RELION processing. Node.js and MongoDB are auto-installed by the install script in all modes.

Setup

Choose an installation mode. All four produce the same CryoProcess instance.

Production

Requires sudo. Installs system-wide. Runs as systemd service with auto-start on boot.

Install & Start

Install$sudo ./cryoprocess.sh install

Start$./cryoprocess.sh service start

Open in browser

Visit http://localhost:8001 to access CryoProcess.

Default Admin Credentials

Email: admin@example.com

Password: admin123

Change the password immediately after first login.

Daily Operations

Stop$./cryoprocess.sh service stop

Restart$./cryoprocess.sh service restart

Status$./cryoprocess.sh service status

Logs$./cryoprocess.sh service logs

Backup$./cryoprocess.sh backup

Build$./cryoprocess.sh build

Reconfigure$./cryoprocess.sh reconfigure

Uninstall$./cryoprocess.sh uninstall

Remove daemon$./cryoprocess.sh service uninstall

Dev$./cryoprocess.sh dev

Configuration

All settings live in .env in the project root, auto-generated during install.

Config corrupted?

Run ./cryoprocess.sh reconfigure to regenerate .env from your existing values.

Remote Access

CryoProcess listens on port 8001. Make sure it's reachable from your network.

Open http://your-server:8001 in your browser. Ensure the firewall allows the port:

Ubuntu / Debian

sudo ufw allow 8001/tcp

RHEL / CentOS

sudo firewall-cmd --permanent --add-port=8001/tcp
sudo firewall-cmd --reload

Reverse proxy

For HTTPS on port 443, set up Nginx as a reverse proxy. Include proxy_set_header Upgrade $http_upgrade for WebSocket support.

Quick SSH tunnel

ssh -L 8001:localhost:8001 user@your-server then open http://localhost:8001 locally.

Troubleshooting

Common issues and quick fixes.

Support

Need help? Found a bug?

Discussions Report an Issue