Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages

Help for owners

My DigitalOcean server will not start or I cannot get in

Short answer

DigitalOcean's Recovery Console gives browser-based access to a Droplet whatever its network settings, like a keyboard and screen plugged into the server. It needs a root or sudo password, which can be reset in the control panel. Common causes are a full disk, a firewall change or a broken network or SSH setting. Take a snapshot before restarting.

  • Written for business owners
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Does this sound like your situation?

  • My site is down and SSH says connection refused or timed out.
  • The Droplet shows as on but nothing answers.
  • I lost the SSH key or the person with the key left.
  • It stopped working after a software update or a firewall change.
  • The disk is at 100 percent.

Why does this happen?

  1. The disk is full

    DigitalOcean lists a disk at 100 percent usage as a cause of a Droplet that will not boot. Logs, uploads or backups on the same disk can fill it. Resizing first can make it worse; free space through recovery.

  2. A firewall or network setting changed

    A cloud firewall or the server's own firewall that no longer allows SSH, or a broken network setting, makes the server look dead while it runs. The Recovery Console works regardless of network settings and can revert such changes.

  3. Only key login is allowed and the key is gone

    If you normally log in with SSH keys and have no password set, DigitalOcean says to reset the root password from the Droplet's Settings tab and use the temporary password it emails. That is the way back in through the Recovery Console.

  4. The server itself fails to boot

    DigitalOcean's steps for this are to boot from the recovery ISO, connect through the Recovery Console, then check the disk with fsck or open the installed system to find the fault.

  5. The console has limits

    The Recovery Console needs password authentication, does not fully support copy and paste and can misread number keys. DigitalOcean says to use it only for network recovery or booting the recovery ISO.

What can I do about it today?

  1. Check DigitalOcean's status and your emailLook for a notice about the Droplet, and make sure the account is not suspended for billing.
  2. Take a snapshot if the control panel allows itA snapshot is a copy you can restore. Take it before any restart, because a restart can make things worse.
  3. Do not rebuild or destroy the DropletRebuild wipes the disk. Destroy removes the server and its billing. Neither is the first step.
  4. Ask who holds the key and the passwordFind out who knows the root or sudo password, or whether it must be reset in the control panel.
  5. Check if the disk is fullThe control panel graphs show disk use. If it is full, tell your developer before anyone resizes.
  6. Tell customers the site has a technical problemA short honest message is better than silence. Do not promise a time.

When should I bring someone in?

  • No one has a working password and the key is lost.
  • The Droplet holds the only copy of your database.
  • It failed right after an update and still will not boot.

How do I handle it?

  1. Snapshot, then diagnoseSnapshot first. Then through the Recovery Console I check network, firewall, disk and the SSH settings.
  2. Free space safelyIf the disk is full I find what grew and remove only what is safe, such as old logs, after copying anything of value.
  3. Fix access without weakening itFor a lost key I add a new one and keep password login off afterwards.
  4. Restore and verifyServices are started in order and the site and key actions are tested from outside.
  5. Prevent a repeatDisk and uptime alerts, log rotation and a scheduled backup restored once as proof.

The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.

What do owners ask about this?

Is the Recovery Console the same as SSH?

No. It is a browser-based, out-of-band connection that works even when the network or SSH is broken, with limits on copy and paste and typing.

Can I resize to fix a full disk?

Do not start there. DigitalOcean's advice for a full disk is to recover access and free space first.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.

For your developer: the technical fixes

Next step

Want this off your desk?

Send me a few lines on where things stand. I reply within 24 hours.