Skip to content
Simple blog built with Django and React/Redux, deployed with Docker, and served with nginx/uwsgi.
JavaScript CSS Python Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Remove unnecessary files, add more stuff to .gitignore. Mar 14, 2017
LICENSE.txt Update Todo. Mar 14, 2017
docker-compose.yml Update. Mar 14, 2017

This is a very simple blog built with Django, Django REST Framework, React/Redux, and Bootstrap, deployed with Docker, and served with nginx-uwsgi. It can be useful as an example of integrating Django with React, as a starter project, or as a beautiful and simple blogging tool =)

I have built this project by following these two awesome React courses, I highly recommend them to anybody who wants to learn React! This Django REST Framework course really helped me to build the backend, and this course was incredibly helpful for learning Docker.

I have tried to extensively comment the code, so you could easily understand what's going on, and apply it to your own projects.

This is my first project built with all this tech, so if you have suggestions on how to improve it - I'd really appreciate them. I will keep gradually improving this blog and adding more features. Feel free to contribute to this project, report bugs, or fork it and use it for your purposes. I hope you will find it useful!

You can always contact me at, and you can check out the other stuff I'm working on over here.




Installing and running this blog is very simple. Clone this repo, and then simply run:

docker-compose up
(use -d flag to run it in the background)

After that, the blog will be running on the localhost. Isn't Docker amazing? =)

You will also need to attach to the container by running this:

docker exec -i -t backend  /bin/bash

run migrations:

python3.5 migrate

and create an admin user with:

python3.5 createsuperuser

Now you can go to localhost/login url, login and begin blogging!

Important: Before running it on the server, go to backend/config/env, and change "SECRET_KEY" and "POSTGRES_PASSWORD" to something unique.

To deploy it online, go to Digital Ocean, create a Docker droplet, and repeat the same commands. Then you will need to go to the networking tab, and create two A records pointing to the droplet:

Like so:


You can also go to:

to access the admin panel. You can add categories there, if you want to better organize your posts, and you can create a settings object where you can add an about page and fill in the meta info(site title, keywords, etc).


Upcoming features

  • Core settings. Meta info, analytics, about page.
  • Categories
  • Filter by tags.
  • Drafts
  • Email subscriptions.
  • Pagination.
  • Server side rendering.
  • Proper form validation.
  • RSS


  • Sometimes post editor toolbar is yellow
  • After clicking on post, it doesn't always scroll to the beginning of the page, though it should.


  • Don't expose 8000/8080 ports. Access them only with the nginx container.
  • Separate docker-compose files for production and development.
  • Compile and serve frontend files from the /dist directory.
  • Properly use Docker Volume API. Like here
  • Learn to backup DB.
  • Maybe: Copy the code into container instead of using voulmes(if it has advantaeges).
  • Chain together RUN commands in the Dockerfile, for efficiency.


  • Auto Saving.
  • Code syntax highlighting? IPython? MathJax?
  • Create settings page where you can fill in meta info and create categories.
  • Figure out how to properly run multiple instances of the blog on one server.
  • Create page that allows you to just send emails, like on medium?
    //or just customize a notification email about new posts.
  • Themes?
  • Hosting?
  • Export/Import data?
  • Add nested comments?
  • Image upload?

Clean up

You can’t perform that action at this time.