🐳 Get started with your Docker Space!

Your new Space has been created, follow these steps to get started (or read the full documentation)

Start by cloning this repo by using:

Use an access token

# When prompted for a password, use an access token with write permissions.
# Generate one from your settings: https://huggingface.co/settings/tokens
git clone https://huggingface.co/spaces/muellerzr/docker-example

Let's create a simple Python app using FastAPI:


Hint You can also create the requirements file file directly in your browser.


from fastapi import FastAPI

app = FastAPI()

def greet_json():
    return {"Hello": "World!"}
Hint You can also create the app file file directly in your browser.

Create your Dockerfile:

# read the doc: https://huggingface.co/docs/hub/spaces-sdks-docker
# you will also find guides on how best to write your Dockerfile

FROM python:3.9

RUN useradd -m -u 1000 user
USER user
ENV PATH="/home/user/.local/bin:$PATH"


COPY --chown=user ./requirements.txt requirements.txt
RUN pip install --no-cache-dir --upgrade -r requirements.txt

COPY --chown=user . /app
CMD ["uvicorn", "app:app", "--host", "", "--port", "7860"]
Hint Alternatively, you can create the Dockerfile file directly in your browser.

Then commit and push:

				$git add requirements.txt app.py Dockerfile
				$git commit -m "Add application file"
				$git push

Finally, your Space should be running on this page after a few moments!

App port

Your Docker Space needs to listen on port 7860.

Personalize your Space

Make your Space stand out by customizing its emoji, colors, and description by editing metadata in its README.md file.


Read the full documentation for Docker Spaces here.