Self-hosted setup

Server requirements

Self-hosted Tidal PTC gives you the flexibility and performance benefits of your own hardware. Installation is as simple as running a single command, but first the server has to be created. Below are the requirements for installing and running Tidal PTC:

  • Ubuntu LTS 20.04
  • A publicly accessible IP address. This allows Archboard to manage installation and updates for you.
    A domain name and DNS ready. You will need your domain name to point to your IP address using an A DNS - record. DNS records can take up to several hours to be fully propagated.
    Depending on your district size and anticipated load, Tidal PTC only needs 1GB memory/25GB disk/1 CPU, but - 2GB memory and 2 CPU is preferred.
  • SSH access through port 22.
  • It’s not a requirement, but it’s a good security practice to limit access to the server by SSH key only.


Once you have purchased the Self-Hosted plan, you will need to provide a few details to get your subscription up and going. The following steps match each step in your Archboard subscription instructions page.

Before getting started, you’ll need to make sure you have your DNS configured correctly. This varies depending on your own server setup, but typically it will be an “A” DNS record that has the value of a domain/subdomain that you own. The earlier in the process this is done, the better due to the delay that DNS can have to fully propagate the updated record.

  1. The first thing you’ll need to provide is the domain and IP address of the server on which you wish to install Tidal PTC. This is done to verify your license with the IP of the server. If your license and the servers IP address matches, your server can install and update Tidal PTC.

    If your server is behind a proxy, make sure the x-forwarded-for header value is set correctly.

  2. The next step is installing Tidal PTC on your server. You will need to SSH into your server as the root user so everything can be installed correctly.

    After logging into the server, copy and paste the command shown into the command prompt. This will run a script that installs all the dependencies, the Tidal PTC application, as well as a free SSL certificate provided by Let’s Encrypt.

    The entire installation will take about 15 minutes, but could be more or less depending on the hardware and network capabilities. You will be notified via email when it is finished. While the script is running, you can install the Tidal PTC plugin in PowerSchool.

  3. You will need to download the Tidal PTC PowerSchool plugin. There are two options for plugins, depending on your version of PowerSchool. Version 20.11 of PowerSchool introduced a new way to authenticate using single sign on (SSO). After downloading the appropriate version, you can install the plugin on your PowerSchool version.

  4. Once the installation of Tidal PTC on your server and the installation of the PowerSchool plugin is finished and enabled, you need to finish the Tidal PTC application configuration. Visit https://[your-tidal-ptc-domain]/install to complete installation.

    For your convenience, your Archboard subscription instructions page will display some of the information needed on the Tidal PTC installation page, such as license and PowerSchool API details. Once the initial data is saved you will be asked which schools from your PowerSchool instance you would like to integrate into Tidal PTC.

    Saving the selection will automatically pull in the student, teacher and enrollment information. Self-hosted has additional configuration needed before you’re fully ready.


After saving the school selection, you will be taken to Tidal PTC’s district/tenant settings. These settings apply to all the schools on your Tidal PTC server. Users with the district admin role can edit the system settings.

System settings

Learn more about system settings.