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.
| Computer | Download | Open |
|---|---|---|
| macOS | Phynite Compute for macOS | Open Phynite Compute.command |
| Windows 10 / 11 | Phynite Compute for Windows | Open Phynite Compute.cmd |
| Linux | Phynite Compute for Linux | ./phynite-compute |
1. Download and open
- Open Your computer from the avatar menu. The website recommends the correct download for your operating system; links for other supported systems remain available.
- 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.
- 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
- The launcher returns to Your computer with the 12-digit Connection code already filled in. Review the page and choose Connect computer.
- Each code works once and expires after 10 minutes. Only approve a computer you control.
- If another computer is linked, finish or cancel its active calculations before confirming replacement.
- 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
- Open DFT Lab and begin with a small silicon Total energy calculation. Select Your computer as the compute destination.
- Watch the execution log. A queued job waits for your connected computer and earlier dependencies. One calculation runs at a time on this computer.
- For a successful SCF result, check convergence, JOB DONE, and the final Completed state. Completion also requires result upload.
- Open Figure Lab from the completed result. Its data remains linked to the project, source calculation, and numerical settings.
- 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.
| Action | Location |
|---|---|
| Open or restart Phynite Compute | Open the downloaded launcher again |
| Check connection | Your computer in the account menu |
| View technical messages | Advanced manual setup → Show service logs |
| Cancel a calculation | Use Cancel in the execution log and wait for its final state |
Update, disconnect, or move computers
- Finish or cancel active calculations before an update, replacement, or disconnection.
- For an update, download and open the current launcher. It asks before replacing a changed runtime and preserves the private volume.
- 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 see | What to do |
|---|---|
| The local engine is missing | The launcher opens its official installer page. Install it, wait until ready, then reopen Phynite Compute. |
| No code appears | Allow the first runtime download to finish. Reopen the launcher, or use Show service logs under Advanced manual setup. |
| Code expired or was used | Reopen the launcher to request and open the latest code. |
| Approved, but still Offline | First-time library setup can take several minutes. Check service logs and refresh the connection afterward. |
| Job stays queued | Check Connected status, Your computer destination, and completed dependencies. Do not submit a duplicate. |
| OOMKilled / exit 137 | The 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.
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-computeAccess, 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.