The code for the Allsky Website is installed as part of the Allsky installation on your Pi, so no installation is necessary on the Pi, although it needs to be configured before it can be used. Make sure you have Allsky configured and working the way you want it before configuring a Website since some of the Allsky settings are also used by the Website and you don't want to have to change them twice.

If you have an existing Allsky Website on your Pi, the installation of Allsky will move images and videos from the prior Website's directory to the new Website's directory. If the prior Website was version v2022.03.01+ or earlier you need to:

1. Manually copy your prior settings from /var/www/html/allsky/config.js to configuration.json by going to the Editor page in the WebUI and selecting configuration.json (local Allsky Website). Note that there are more settings in the new configuration file, but it should be straightforward to map settings from the old file to the new file.
2. After configuring the local Website, check in /var/www/html/allsky for any files you manually added and store them in ~/allsky/html/allsky/myFiles.
3. Save config.js somewhere in case you need it later.
4. Remove the old Website:

    rm -fr /var/www/html/allsky 

Install a remote Allsky Website

Most people have their Pi behind a firewall where it's not accessible on the Internet, so they install the Allsky Website on a different machine that is accessible on the Internet.

Prior to installing the Website on a remote server, make sure Allsky is working on your Pi, then do the following:

1. On the remote server:
   • Create an allsky directory to hold the Website. Keep track of where on your server you created the directory - you will need that information later when you tell Allsky where to upload the images.
2. On the Pi:
   1. Copy ALL files and directories in ~/allsky/html/allsky to the allsky directory on your remote Website.
      Do this using whatever procedure you use to copy other files there.
   2. Go to the Websites and Remote Server Settings section in the WebUI's Allsky Settings page. Update the settings in the Remote Website subsection. Make sure to enable Use Remote Website as well as enough other settings so Allsky can upload a file to the Website.
   3. Run cd ~/allsky; ./remoteWebsiteInstall.sh to upload a default configuration file to your server, leaving the master copy on the Pi.
      • If the upload fails, see the Troubleshooting uploads page on how to debug the problem.
      • If you previously enabled the local Allsky Website, the remote configuration file will be identical to the local one with the exception of the imageName setting which will be configured for the remote Website.
        If you want the remote configuration to differ from the local one (for example, to add a background image to the remote Website), edit the remote configuration file - see the next step.
   4. Configure the remote Website:
      • In the WebUI, click on the Editor link.
      • In the drop-down at the bottom of the page, select remote_configuration.json (remote Allsky Website).
      • See the Settings -> Allsky Website page for details on the settings.
      • A copy of the remote Website configuration file will be uploaded to the server.

      Whenever you update the remote Website's configuration you must do so via WebUI following the steps above. Do NOT edit the configuration file directly on the remote server.

3. Your remote server is now ready.
4. Give your family and friends the URL to your Allsky Website so they can enjoy your images!

Remote Website Requirements

The remote server needs to support the following:

• PHP version 7 or newer.
• The imagecreatefromjpeg function in PHP to create thumbnails of the startrails and keogram files. If that function does not exist (which is rare), you'll see a thumbnail that says "No thumbnail". Everything else will still work.
• The ffmpeg command and exec function in PHP to create thumbnails of the timelapse videos.

  Most hosting solutions don't support those commands for security reasons. In that case, make sure Upload Timelapse Thumbnail is enabled (and Upload Mini-Timelapse Thumbnail if you are creating mini timelapses). Failure to set those variables will result in "No thumbnail" messages when viewing videos. Everything else will still work.

Post installation

Change Allsky Website Settings as desired so the Website looks and behaves like you want. Changes to both local Websites and remote Websites are done via the WebUI.

If you have both a local and a remote Website, they each have their own configuration file which is accessible via the WebUI's Editor page. They are NOT automatically kept in sync so if you change something, for example, the lens, you'll need to change it in both files.