Skip to content
phynite-lab
Phynite DocumentationDownload

Connect your computer with Phynite Compute

Run DFT and molecular-dynamics calculations on your own computer through one Phynite connection. Download the helper for your operating system, open it, and approve the connection in your account. Phynite Compute prepares the verified Quantum ESPRESSO, LAMMPS, and OVITO runtimes for you.

Complete guide

Before you start

Phynite Compute reserves up to 4 CPUs and 8 GiB for a job. A computer with 16 GB of installed RAM is a useful starting point. Required capacity still depends on the atoms, cutoffs, k-points, bands, and calculation type.

Keep several GB of disk space free for the verified runtime and scientific libraries, plus working space for results. Internet is needed to connect the account, receive calculations, and upload results.

ComputerDownloadOpen
macOSPhynite Compute for macOSOpen Phynite Compute.command
Windows 10 / 11Phynite Compute for WindowsOpen Phynite Compute.cmd
LinuxPhynite Compute for Linux./phynite-compute

1. Download and open

  1. Open Your computer from the avatar menu. The website recommends the correct download for your operating system; links for other supported systems remain available.
  2. Extract the ZIP and open its launcher. The helper checks the local engine and opens its official installer page only when that prerequisite is missing.
  3. The first setup downloads a pinned, architecture-compatible scientific runtime. Later launches reuse it and preserve the private Phynite Compute volume.

2. Approve this computer

  1. The launcher returns to Your computer with the 12-digit Connection code already filled in. Review the page and choose Connect computer.
  2. Each code works once and expires after 10 minutes. Only approve a computer you control.
  3. If another computer is linked, finish or cancel its active calculations before confirming replacement.
  4. After approval, Phynite Compute downloads and verifies the scientific libraries. Wait until the web status changes to Connected. That single connection enables both DFT Lab and MD Lab.

3. Run your first calculation

  1. Open DFT Lab and begin with a small silicon Total energy calculation. Select Your computer as the compute destination.
  2. Watch the execution log. A queued job waits for your connected computer and earlier dependencies. One calculation runs at a time on this computer.
  3. For a successful SCF result, check convergence, JOB DONE, and the final Completed state. Completion also requires result upload.
  4. Open Figure Lab from the completed result. Its data remains linked to the project, source calculation, and numerical settings.
  5. Open MD Lab and run a small Lennard-Jones equilibration. It uses the same connected computer and does not require a second pairing.

Everyday use

The private Phynite Compute volume remembers the connection and downloaded libraries. Keep the computer awake and internet available while a calculation is active; the website may be closed.

Stopping the local engine or putting the computer to sleep can interrupt a calculation. Restore connectivity and inspect the job state before sending a duplicate. Completed local work files are cleaned up after three days.

ActionLocation
Open or restart Phynite ComputeOpen the downloaded launcher again
Check connectionYour computer in the account menu
View technical messagesAdvanced manual setup → Show service logs
Cancel a calculationUse Cancel in the execution log and wait for its final state

Update, disconnect, or move computers

  1. Finish or cancel active calculations before an update, replacement, or disconnection.
  2. For an update, download and open the current launcher. It asks before replacing a changed runtime and preserves the private volume.
  3. To move computers, disconnect the old one in Your computer, download Phynite Compute on the new machine, and approve its new code.

Troubleshooting

What you seeWhat to do
The local engine is missingThe launcher opens its official installer page. Install it, wait until ready, then reopen Phynite Compute.
No code appearsAllow the first runtime download to finish. Reopen the launcher, or use Show service logs under Advanced manual setup.
Code expired or was usedReopen the launcher to request and open the latest code.
Approved, but still OfflineFirst-time library setup can take several minutes. Check service logs and refresh the connection afterward.
Job stays queuedCheck Connected status, Your computer destination, and completed dependencies. Do not submit a duplicate.
OOMKilled / exit 137The calculation exceeded available memory. Reduce system size or bands only where scientifically appropriate.

Advanced manual diagnostics

Normal setup does not require Terminal or PowerShell. Support may ask you to run the pinned command or read recent service logs. These commands use the same read-only, non-root Docker runtime as the launcher.

Example / commands
docker run -d --name phynite-compute --restart unless-stopped --init --read-only --cap-drop ALL --security-opt no-new-privileges --pids-limit 512 --cpus 4 --memory 8g --tmpfs /tmp:rw,size=512m -v phynite-compute:/state public.ecr.aws/p8i3a1t8/phynite/personal-compute@sha256:2e478dd301384eaa9ea754fcf6630de7fe7ad1ccb114fb5f5c5d8dba3d49a185
docker logs --tail 30 phynite-compute

Access, data, and scientific checks

The isolated service receives only calculations belonging to the account that approved its code. Disconnecting revokes access. No incoming port, Docker socket, or host home folder is shared.

The runtime uses a read-only image, dedicated storage volume, non-root user, and CPU, memory, and process limits. It requires outgoing internet access for Phynite and verified library downloads.

Local machine owners can modify their own software. Account binding protects access to other accounts; it does not certify a scientific result. Check convergence, numerical settings, solver versions, and pseudopotentials before publication.

Related topics