← Back to Guides
Profile image for Thomas Smyth

By Thomas Smyth

Published 1st June 2022

Shynet is a free open-source, modern, privacy-friendly, and cookie-free web analytics framework. This guide will show you how to deploy Shynet on Northflank using their public Docker image and a Postgres database to store data across restarts.
  1. Create a new Postgres addon.

    • Choose the storage size according to your needs, it can be increased later if your storage needs change.

    Deploy Shynet on Northflank, Postgres addon creation

  2. Create a new secret group and link the following variables from the Postgres addon created in the previous step and assign them the respective aliases.

    Variable nameAlias
    HOSTDB_HOST
    PORTDB_PORT
    USERNAMEDB_USER
    PASSWORDDB_PASSWORD
    DATABASEDB_NAME

    Secret group creation for the deployment of Shynet on Northflank

  3. Create a new deployment service and under deployment, select external image with the path milesmcc/shynet:latest.

    • Port 8080 will automatically be detected from the image manifest and will be exposed with the HTTP protocol.

    Shynet deployment in Northflank, using the official image

  4. Wait for the Shynet instance to start up and open the web interface by clicking on the link in the top right corner of your service.

    • It will take approximately a minute for the Shynet instance to start up.

    Sign in to the newly created Shynet instance

  5. On the web interface you will be prompted to sign in, however, first you must create an admin user.

    1. Inside your service navigate to the “Containers” menu item.

    2. Open the shell access for the active container, in the shell run ./manage.py registeradmin <your email>.

    3. Login using the randomly generated password logged in the shell. Once you have logged in, you will be able to start creating new services to track the analytics of.

    Password found in the shell, allowing you to log in to Shynet

    Shynet dashboard

If you encounter any issues while following this guide we're happy to assist you with your Shynet deployment at support@northflank.com. At Northflank we also have dedicated support plans for business customers.

Using Northflank to deploy Shynet

Northflank allows you to deploy your code and databases within minutes. Sign up for a Northflank account and create a free project to get started.

  • Connect with your preferred VCS: GitHub, GitLab or Bitbucket
  • Deployment of Docker containers
  • Scale vertically and horizontally with multiple replicas per service
  • Observe & monitor with real-time metrics & logs
  • Low latency and high performance
  • Multiple read and write replicas

Share this article with your network