Skip to content

Snapshots and recovery ​

netcup snapshots ​

A snapshot copies the whole disk, so restoring one puts the server back exactly as it was. netcup doesn't charge for them.

This server boots with UEFI, so only offline snapshots work. infra snapshot create handles the whole sequence:

  1. shut the server down cleanly
  2. check the snapshot is allowed (a dry run)
  3. take it, and wait for netcup's task to finish
  4. start the server again, and wait for it to report RUNNING

It takes about 4 minutes, and everything on the server is down while it runs.

sh
infra snapshot list
infra snapshot create before-upgrade "why I took it"
infra snapshot revert before-upgrade      # everything since is lost
infra snapshot delete before-upgrade

Take one before anything risky to the server itself: big upgrades, firewall or SSH changes, Coolify upgrades.

netcup's API ​

The CLI and the ops page each have their own netcup login, created with a device-code flow (infra netcup login). The refresh token doesn't expire as long as it's used at least once every 30 days.

Logging in to netcup's server panel needs its own password, not the customer panel one. The easy way is to open the customer panel, click SCP Auto-Login, then open the device-code link in the same browser, which then only asks you to approve.

When nothing else works ​

If SSH and the web are both gone:

  1. Run infra power status. Is it even running? If not, infra power on.
  2. If it's running but unreachable, go to netcup's customer panel → SCP Auto-Login → the server → Screen or Console. That's a direct console, which needs no network.
  3. If the server is beyond saving, infra snapshot revert <name>.
  4. If the snapshots are gone too, follow the rebuild steps in the repo's runbooks (docs/runbooks/).