#dusanmitrovic.xyz

Source code for my website.

#Table of contents

• Configure hosts
• Run docker development environment
• Run migrations
• Run seeds
• Services
• Production setup
• Licensing

#Configure hosts

Add these lines to the end of your /etc/hosts file.

127.0.0.1 website.test
127.0.0.1 website-smtp.test
127.0.0.1 website-db.test

These will be used to access the website and its services in development.

#Run docker development environment

This will bootstrap the development environment and all its dependencies.

docker compose -f ./docker/development/docker-compose.yaml up -d

#Run migrations

This is necessary to update the database schema.

docker exec website-node knex migrate:latest

#Run seeds

If you want to seed the databse with some fake data run this command.

docker exec website-node knex seed:run

#Services

The docker environment will start the following services.

• nginx (Serves as a proxy, you must have port 80 available on your machine)
• mariadb (Main data store)
• redis (For managing user sessions)
• phpmyadmin (Available at http://website-db.test )
• smtp4dev (Available at http://website-smtp.test )
• website (Available at http://website.test )

#Production setup

Docker is meant for development only. To host the webiste in production you must manage the environment yourself.

Requirements:

• nginx
• redis
• mariadb >= 10.7
• node >= 16
• npm (or any other node package manager of your choice)
• pm2 (optional)

To minify CSS for production (required) run:

npm run minify-css

If you're using PM2 as your node service manager an example confifguration is provided. Edit it to suit your needs.

It also lists all the environment variables that need to be configured.

#Licensing

All source code written for this website is licensed under the terms of GNU AGPLv3.

All content on this website is licensed under the terms of CC-BY-SA.