# failed to parse Dockerfile: file with no instructions How to fix it.

URL: https://antideploy.com/blog/empty-dockerfile

The Dockerfile in your project is empty. Add the instructions it needs, or delete it.

**What you see**

```
failed to parse Dockerfile: file with no instructions
```

## At a glance

- **What it means**: The file has no instructions
- **Fix one**: Delete the file
- **Fix two**: Write a real Dockerfile
- **Common with agents**: An empty file is easy to leave behind

Published 7 October 2026. Facts checked 7 October 2026. 1 min read.

## What it means

There is a file named `Dockerfile` at the root of your project, and it has nothing in it. A Dockerfile is the recipe for building a container. With no steps, there is nothing to build.

## How to fix it

**Delete it.** If you do not need a Dockerfile, remove the empty file. Antideploy then builds your project the way it builds any project without one.

**Or write it.** If you want your own Dockerfile, add the steps it needs. Your start command, and the port you declare with `EXPOSE`, come from this file.

A small working example for a Node app:

**Dockerfile**

```
FROM node:22-slim
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
EXPOSE 3000
CMD ["node", "server.js"]
```

## Why it happens

An agent or a template can create the file and never fill it in. Antideploy now declines to build with an empty Dockerfile in the first place, but a failure of this kind can still reach you from an older setup.

## Dockerfile questions, answered.

Anything else? Write to us and a person answers.

[support@antideploy.com](mailto:support@antideploy.com)

### Do I need a Dockerfile at all?

No. Antideploy reads your project and builds it for you. See [Do I need Docker, Kubernetes or YAML to deploy?](https://antideploy.com/blog/do-i-need-docker-kubernetes-or-yaml-to-deploy).

### Where must the Dockerfile be?

At the root of your project. A Dockerfile in a subfolder cannot be used.

### Does this failed deploy cost anything?

No. Failed deploys never count against your plan.

## More guides, and the platform.

Each platform page covers one part of Antideploy: what it does, where it stops and the questions people ask. [See the whole platform](https://antideploy.com/platform), or [all the guides](https://antideploy.com/blog).

- [How to deploy a Docker app with your own Dockerfile](https://antideploy.com/blog/how-to-deploy-a-docker-app-with-your-own-dockerfile): Where the Dockerfile must be, how the port is read, the account rule and the RUN --mount limit.
- [Do I need Docker, Kubernetes or YAML to deploy?](https://antideploy.com/blog/do-i-need-docker-kubernetes-or-yaml-to-deploy): No. What each one is, why one app does not need them, and when a Dockerfile is still worth it.
- [sh: 1: vite: not found](https://antideploy.com/blog/sh-command-not-found-during-the-build): The build ran a command that is not installed. Add the package, or use a Dockerfile for system programs.

- [Deployments](https://antideploy.com/platform/deployments)
- [Hosting](https://antideploy.com/platform/hosting)

Facts on this page were checked against the live platform on 7 October 2026.

## Deploy something. Start with one sentence.

Paste one sentence into your coding agent, click Approve once, and get a live link. No card, no trial clock.

To set this up, give your coding agent this sentence:

```text
Set this project up to deploy on Antideploy. Fetch https://antideploy.com/agent.md and follow it.
```