Skip to content

Host your own slidesk.link

slidesk.link is open source: run your own hub to keep your addons, hosted presentations and talks inside your company. Its sources are at slidesk/slidesk.link.

Create a GitHub OAuth app

Users log in with GitHub. Create an OAuth app with:

  • Homepage URL: the public URL of your hub, for instance https://hub.example.com
  • Authorization callback URL: https://hub.example.com/login/github/authorized

Keep its client ID and generate a client secret.

Configure

The hub reads its configuration from the environment, or from a .env file:

Variable
HOST the public URL of the hub, without a trailing slash. Unset, the hub runs as http://localhost:3000 for development
GITHUB_OAUTH_CLIENT_ID the client ID of the OAuth app
GITHUB_OAUTH_CLIENT_SECRET its client secret
JWT_SECRET a long random string signing the sessions, required once HOST is set (openssl rand -hex 32)
DATABASE_PATH the sqlite file, ./app/dev.db by default

The sqlite database is created and migrated when the hub starts.

Run with Docker

The image is gouz/slidesk-link, for amd64 and arm64. It listens on port 3000 and keeps the addons, presentations and database in /usr/src/app/app: put it on a volume.

docker run -d --name slidesk-link \
  -p 3000:3000 \
  --env-file .env \
  -v slidesk-link-data:/usr/src/app/app \
  gouz/slidesk-link:latest

Serve it behind a reverse proxy with HTTPS on the HOST URL.

Run with Bun

git clone https://github.com/slidesk/slidesk.link.git
cd slidesk.link
bun install
bun run build
bun dist-server/index.js

Use it from SliDesk

Every link and addon command takes --slidesk-link-url:

slidesk link login --slidesk-link-url https://hub.example.com
slidesk link host --slidesk-link-url https://hub.example.com
slidesk plugin install @author/name --slidesk-link-url https://hub.example.com
slidesk update --slidesk-link-url https://hub.example.com

SliDesk keeps a single token, in ~/.slidesk: log in again with slidesk link login --force when you switch between slidesk.link and your hub.