Set up your environment (using containers)

It is now easier to get started on developing the Fedora Websites with the use of Docker (or Podman).

We ship a Dockerfile which will install dependencies into an image for you, so all you are left to do is mount the site as a volume, pull translations, and start the development server.

First clone the repository:

(You may instead clone your fork of it, or add your fork as a second remote later on.)

Now ensure Docker is running and run:

This will generate a container image for you to use.

We have a script for pulling translations. Let’s call it from within the container:

Notice here that we are mounting a volume (-v) in Docker which points to our check-out of the repository. We’re referring to the fedora-websites image created above, and calling the ./scripts/pull-translations.sh script from within it.

Now we are ready to run the development server:

Note that we need -p 5000:5000 so that we can access the development server from our actual host. Also notice that we need to tell Flask to listen on 0.0.0.0 as by default it listens on 127.0.0.1 which won’t be accessible outside of the container.

You may now go to http://localhost:5000/ in your browser of choice.

Now you are ready to go and any changes you make in the repository should be reflected immediately upon refreshing the page in your browser.