crypticcreator/selene repository overview

This is scratch image using musl and statically compiled C/C++ dependencies. Last measured to be 20.5MB.

⁠Prerequisites

If your host does not already have one, it is suggested to make a selene group with the GID 53137.

groupadd -g 53137 selene

⁠Run with Docker CLI

docker run -d \
	--name selene \
	--user 65532:53137 \
	--restart unless-stopped \
	-p 53137:53137 \
	-e SELENE_DISPLAY_NAME=Selene \
	-e SELENE_IP=0.0.0.0 \
	-e SELENE_PORT=53137 \
	-v /opt/docker/selene:/selene \
	-v /path/to/music:/selene/music \
	selene:latest

⁠Run with Docker Compose

services:
   selene:
      image: selene:latest
      user: "65532:53137"
      container_name: selene
      restart: unless-stopped
      ports:
         - 53137:53137
      environment:
         SELENE_DISPLAY_NAME: Selene
         SELENE_IP: 0.0.0.0
         SELENE_PORT: 53137
      volumes:
         - /opt/docker/selene:/selene
         - /path/to/music:/selene/music

⁠Post Installation

After installation, you'll need a selene client to communicate with the server. See the main repository⁠ for more information about installing clients.

When the server is run, if no admin accounts are currently present, an "Admin bootstrap token" will be printed to /selene/data/admin-bootstrap-token. Copy this token and create an account with it using your client of choice.

This token will be invalidated every time the server restarts and when used. Future admin accounts will have to be made by changing the permissions of other accounts from the 'bootstrapped' admin account.

For example, if you are using the official selene-cli, the command is:

selene remote <ORIGIN> account-register <NAME> --admin-token=<ADMIN BOOTSTRAP TOKEN>

ORIGIN is the server origin, eg. http://127.0.0.1:53137. NAME is the name of the admin account. ADMIN BOOTSTRAP TOKEN is the token you copied.