Installation#

On this page, you will find all information to run SunPeek via Docker, which is the main way of using SunPeek. As an alternative, you can also use SunPeek right away using the demo server.

Note

This section covers the installation with Docker. If you are interested in using the Backend separately (e.g. as standalone Python library) instead, please check out the dedicated topic Using the Backend directly.

What is installed?#

SunPeek consists of multiple software parts that are shipped together using Docker. While you don’t necessarily need to know all details, having a rough grasp of the architecture will help you gain a better understanding of SunPeek.

../../_images/SunPeek_Architecture.png

These are the three main building blocks of SunPeek:

  • The Web UI is the graphical user interface, allowing user to interact with SunPeek in the browser.

  • The Backend is a Python library that contains all the algorithms for using SunPeek. The WebUI (but also other software tools) can interact with it using the restful API.

  • The Database stores the data, so configuration and data upload only needs to be done once.

Hint

As SunPeek is installed locally at your own computer (or server), the database cannot be accessed by other people (except you or your IT-administrator allows it). Hence, your data will be kept confidential when using SunPeek.

To ease-up the installation process, we have chosen to ship everything using Docker. Docker is a third-party software, that makes sure that programs run on every computer - independently of the operating system.

Installing SunPeek#

The installation instructions are depending on the operating system:

Using Windows

Instructions to install SunPeek on a Windows computer

Installation with Windows
Using Linux

Instructions to install SunPeek on a Linux computer or server

Installation with Linux

The Demo-Server#

Instead of installing SunPeek yourself, you can also use the demo server. This is a freely-accessible website which hosts a up-to-date instance of SunPeek. The aim of the demo server is to allow user to test the application, before they install SunPeek. However, we encourage you to setup your own version of SunPeek, to ensure that data is only accessible to you.

You can access the demo server here.

Warning

Please note that data uploaded to the demo server is accessible to everyone - in contrast to installing it on your own device. If you are worried about data security, please install SunPeek locally instead of using the demo Server.