Skip to content

DOCKERLESS.md

Latest commit

 

History

History
185 lines (148 loc) · 5.31 KB

DOCKERLESS.md

File metadata and controls

185 lines (148 loc) · 5.31 KB

Dockerless Installation

If you want to run streamystats but do not want to use docker, you can with a bit of elbow grease! This guide assumes you have at least basic linux and postgres knowledge. This has been tested on *Debian Trixie.

PostgreSQL

Streamystats depends on the vector extension on Trixie this is now available as a package.

Installing PostgreSQL:

# NOTE: on Debian Trixie, the default PostgreSQL version is 17.
apt install postgresql postgresql-client postgresql-17-pgvector
systemctl enable --now postgresql@17-main.service

Creating the database

export PG_VER=17
export DB_NAME=streamystats
export DB_PASS=$(pwgen -s 24 1)

echo "Creating ${DB_NAME} role with password: ${DB_PASS}"
echo "CREATE USER ${DB_NAME} WITH LOGIN PASSWORD '${DB_PASS}';" | sudo -i -u postgres psql
echo "CREATE DATABASE ${DB_NAME} OWNER ${DB_NAME};" | sudo -i -u postgres psql

cat >> /etc/postgresql/${PG_VER}/main/pg_hba.conf << EOF
# ${DB_NAME}
host    ${DB_NAME}      ${DB_NAME}      127.0.0.1/32    scram-sha-256
host    ${DB_NAME}      ${DB_NAME}      ::1/128         scram-sha-256
EOF

export DATABASE_URL=postgresql://${DB_NAME}:${DB_PASS}@localhost:5432/${DB_NAME}
echo 'CREATE EXTENSION IF NOT EXISTS "uuid-ossp";' | psql "$DATABASE_URL"
echo 'CREATE EXTENSION IF NOT EXISTS "vector";' | sudo -u postgres psql -d ${DB_NAME} # NOTE: need super user

Streamystats

Everything except the database, systemd unit and bun will be contained within /opt/streamystats.

Installing bun

For more information see https://bun.sh/

curl -fsSL https://bun.sh/install | bash

Installing from source

Cloning the source:

git clone https://github.com/fredrikburmester/streamystats.git /opt/streamystats/src

cd /opt/streamystats
bun install --frozen-lockfile

Configuration

You should still have the DB_NAME and DB_PASS variables set from earlier, if not replace them with the correct values!

This configuration listens on localhost so needs to be placed behind a reverse proxy. Change this as needed for your setup.

!! The openssl command is not escaped so when copying these commands to create the .env files a random secret will be generated.

mkdir -p /opt/streamystats/etc
cat > /opt/streamystats/etc/db.env << EOF
DATABASE_URL=postgresql://${DB_NAME}:${DB_PASS}@localhost:5432/${DB_NAME}
TZ=UTC
EOF

cat > /opt/streamystats/etc/job-server.env << EOF
HOST=localhost
PORT=3005
EOF

cat > /opt/streamystats/etc/nextjs-app.env << EOF
HOST=localhost
PORT=3000
#NEXT_PUBLIC_BASE_PATH=/streamystats
JOB_SERVER_URL=http://localhost:3005
SESSION_SECRET="$(openssl rand -hex 64)"
EOF

Running with systemd

useradd --system --home /opt/streamystats --create-home --shell /usr/sbin/nologin --user-group streamystats
chown -R streamystats:streamystats /opt/streamystats/{src,etc}

cat > /lib/systemd/system/streamystats-db-migration.service << EOF
[Unit]
Description=Streamystats is a statistics service for Jellyfin, providing analytics and data visualization.
Requires=network-online.target
#Requires=sssd.service

BindsTo=postgresql@15-main.service
After=postgresql@15-main.service

[Service]
EnvironmentFile=/opt/streamystats/etc/db.env
Environment=PATH=/usr/bin:/bin:/usr/local/bin
Environment=NODE_ENV=production
Type=oneshot
WorkingDirectory=/opt/streamystats/src/packages/database
ExecStart=bun run db:migrate
User=streamystats
Group=streamystats
PrivateTmp=true
SyslogIdentifier=streamystats-db-migration
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target
EOF

cat > /lib/systemd/system/streamystats-job-server.service << EOF
[Unit]
Description=Streamystats is a statistics service for Jellyfin, providing analytics and data visualization.
Requires=network-online.target
#Requires=sssd.service
Requires=jellyfin.service
After=streamystats-db-migration.service

BindsTo=postgresql@15-main.service
After=postgresql@15-main.service

[Service]
EnvironmentFile=/opt/streamystats/etc/db.env
EnvironmentFile=/opt/streamystats/etc/job-server.env
Environment=PATH=/usr/bin:/bin:/usr/local/bin
Environment=NODE_ENV=production
Type=simple
WorkingDirectory=/opt/streamystats/src/apps/job-server
ExecStart=bun start
User=streamystats
Group=streamystats
PrivateTmp=true
SyslogIdentifier=streamystats-job-server
StandardOutput=journal
StandardError=journal
Restart=always

[Install]
WantedBy=multi-user.target
EOF


cat > /lib/systemd/system/streamystats-nextjs-app.service << EOF
[Unit]
Description=Streamystats is a statistics service for Jellyfin, providing analytics and data visualization.
Requires=network-online.target
#Requires=sssd.service
Requires=streamystats-job-server.service

[Service]
EnvironmentFile=/opt/streamystats/etc/db.env
EnvironmentFile=/opt/streamystats/etc/nextjs-app.env
Environment=PATH=/usr/bin:/bin:/usr/local/bin
Environment=NODE_ENV=production
Environment=NEXT_TELEMETRY_DISABLED=1
Type=simple
WorkingDirectory=/opt/streamystats/src/apps/nextjs-app
ExecStart=/bin/bash -c 'bun run build && bun start'
User=streamystats
Group=streamystats
PrivateTmp=true
SyslogIdentifier=streamystats-nextjs-app
StandardOutput=journal
StandardError=journal
Restart=always

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable --now streamystats-db-migration.service
systemctl enable --now streamystats-job-server.service
systemctl enable --now streamystats-nextjs-app.service
⚡