This repository has been archived on 2023-05-27. You can view files and clone it, but cannot push or open issues or pull requests.
Sam Therapy debd7328c8
All checks were successful
continuous-integration/drone/push Build is passing
forgor the fork info
Signed-off-by: Sam Therapy <>
2023-01-11 16:18:09 +01:00

4.2 KiB



You will need a Twitter API key to make BirdsiteLIVE working. First create an Standalone App in the Twitter developer portal and retrieve the API Key and API Secret Key.

Server prerequisites

Your instance will need docker and docker-compose installed and working.


Download the docker-compose file:

sudo curl -L -o docker-compose.yml

Then edit file:

sudo nano docker-compose.yml

Attributes to change in the docker-compose file

Personal info

  • Instance:Domain the domain name you'll be using, for example use for the URL
  • Instance:AdminEmail the admin's email, will be displayed in the instance /.well-known/nodeinfo endpoint
  • Twitter:ConsumerKey the Twitter API key
  • Twitter:ConsumerSecret the Twitter API secret key

Database credentials

The database credentials must be changed the same way in the server and db section.

  • database name:
    • Db:Name
  • database user name:
    • Db:User
  • database user password:
    • Db:Password


Launch the app with:

docker-compose up -d

By default the app will be available on the port 5000

Nginx configuration

Fill your service block as follow:

server {
    listen        80;
    location / {
        proxy_pass         http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection keep-alive;
        proxy_set_header   Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;

Save and start/restart your Nginx service

sudo service nginx start
# or restart it if its already started
sudo service nginx restart

Secure your hosted application with SSL

After having a domain name pointing to your instance, install and setup certbot:

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d

Make sure you're redirecting all traffic to https when asked.

Finally check that the auto-renewal will work as expected:

sudo certbot renew --dry-run


Or, you can use caddy {
        encode gzip
        header ?Cache-Control "max-age=3600"
        reverse_proxy http://localhost:5000 {
            header_down -Server


Set the firewall

Make sure you're securing your firewall correctly:

sudo apt install ufw #if not installed
sudo ufw app list
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status

You should now have an up and running BirdsiteLIVE instance!


Make sure your data belong outside the containers before migrating (set by default).

To update your installation to the latest release:

# Edit `docker-compose.yml` to update the version, if you have one specified
# Pull new images
docker-compose pull
# Start a new container, automatically removes old one
docker-compose up -d


To set auto-updates on your deployment, add to the docker-compose.yml file this section:

version: "3"

        external: false

        image: pasture/birdsitelive:latest

        image: postgres:13
+   watchtower:
+       image: containrrr/watchtower
+       restart: always
+       container_name: watchtower
+       environment:
+           - WATCHTOWER_CLEANUP=true
+       volumes:
+           - /var/run/docker.sock:/var/run/docker.sock
+       command: --interval 300

More options

You can find more options available here