vikarti.anatra/polaris-mirror
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
polaris-mirror/docs/SETUP.md
Antoine Gersant 32e67dc095 DDNS polish
2024-10-09 16:45:50 -07:00

2.5 KiB
Raw Blame History

Getting Started

Requirements

One of the following:

  • Windows 7 or newer
  • Linux (any reasonably modern distribution should do)

Windows

  1. Download the latest installer (you want the .msi file)
  2. Run the installer
  3. Launch Polaris from the start menu
  4. In your web browser, access http://localhost:5050

Linux

Dependencies

  1. Install OpenSSL, SQLite and their headers, and some development tools. These are available from your distribution's package manager. For instance on Ubuntu, execute sudo apt-get install binutils pkg-config libssl-dev
  2. Install the Rust compiler by executing curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh or using an alternative method

Polaris installation

  1. Download the latest release of Polaris (you want the .tar.gz file)
  2. Extract the Polaris archive in a directory and open a terminal in that directory
  3. To install Polaris within your home directory, execute make install-xdg. This installation follows the XDG Base Directory Specification. You can use make preview-xdg to see which directories the install process would use.
  4. If you prefer a system-wide install, execute make install (without the -xdg suffix). If you use sudo to perform such a system install, you may need the -E option so that your sudo user find the Rust binaries: sudo -E make install. This installation follows the GNU Standard Installation Directories. You can use make preview to see which directories the install process would use.

From here, you might want to adjust your system to run Polaris on login using Systemd, Cron or whichever method your distribution endorses.

If you want to uninstall Polaris, execute make uninstall-xdg from the extracted archive's directory (or make uninstall if you made a system-wide install). This will delete all the files and directories listed above (including your configuration, playlists, etc.). If you customized the install process by specifying environment variables like PREFIX, make sure they are set to the same values when running the uninstall command.

In a docker container

To run polaris from a Docker container, please follow instructions from the docker-polaris repository.