Démarrage rapide

Exécutez le package SQLly Embedded sur localhost en cinq minutes : démarrez le pont et l'application exemple, liez une licence, ajoutez un profil, et ouvrez SQLly en tant qu'utilisateur.

Ceci exécute le package complet SQLly Embedded sur une seule machine : le pont, son moteur et l'application d'administration exemple. Tout reste sur localhost, et l'essai gratuit sur votre compte sqlly.app le couvre. Vous avez besoin de Node.js 20 ou ultérieur, ainsi qu'une base de données que SQLly peut atteindre.

Exécutez-le

  1. Téléchargez et décompressez le package SQLly Embedded pour votre plateforme depuis Téléchargements (Linux x86-64 et arm64, macOS Apple silicon, Windows x86-64 et arm64). Sur Linux, décompressez avec tar -xzf afin que les exécutables conservent leurs permissions.

    Pour scripter l'installation, chaque plateforme dispose d'un lien stable qui sert toujours le dernier package construit pour cette plateforme. Si une version n'a pas pu être construite pour votre plateforme, le lien sert la plus récente qui a pu l'être.

    PlateformeDernier package
    Linux x86-64https://sqlly.app/download/embedded/latest/linux-amd64
    Linux arm64https://sqlly.app/download/embedded/latest/linux-arm64
    macOS Apple siliconhttps://sqlly.app/download/embedded/latest/macos-arm64
    Windows x86-64https://sqlly.app/download/embedded/latest/windows-amd64
    Windows arm64https://sqlly.app/download/embedded/latest/windows-arm64
    curl -fsSL -o sqlly-embedded.tar.gz https://sqlly.app/download/embedded/latest/linux-amd64
    tar -xzf sqlly-embedded.tar.gz

    Ajouter /version à l'un d'entre eux (par exemple /download/embedded/latest/linux-amd64/version) pour obtenir la version et le nom du fichier en JSON sans téléchargement.

  2. Démarrer tout depuis la sqlly-embedded dossier :

    macOS / Linux
    ./start-sample.sh
    Windows
    start-sample.cmd

    Le script crée .env de .env.example, vérifie Node.js, génère le jeton de gestion partagé lors du premier lancement, démarre le pont, attend son API de gestion, et démarre l'application exemple sur http://127.0.0.1:8090.

  3. Connectez-vous en tant qu'administrateur à http://127.0.0.1:8090/admin avec sqlly-admin / GoodLittlePiggy. (L'application exemple refuse d'écouter sur autre chose que le loopback jusqu'à ce que vous changiez ce mot de passe.)

  4. Lier une licence. Activé Statut, cliquez sur Connectez-vous à sqlly.app, puis Ouvrez sqlly.app pour approuver. Connectez-vous à sqlly.app, vérifiez que le code correspond à celui de votre page admin, choisissez une licence (votre essai fonctionne) et cliquez Approuver. La page d'état se met à jour automatiquement et affiche le compte lié. Cette installation a maintenant sa propre clé, que le pont conserve même après un redémarrage.

    Vous préférez configurer vous-même ? Générez une clé sur votre page Embedded et définissez SQLLY_EMBEDDED_LICENSE_KEY dans .env avant de démarrer. Les plans hors ligne définissent SQLLY_EMBEDDED_LICENSE_FILE vers le fichier téléchargé à la place.

  5. Créez un profil. Profils → Créer un profil, donnez-lui un nom et ajoutez une connexion : choisissez le moteur, remplissez le serveur, la base de données et l'authentification. Cliquez Test pour prouver que le pont peut y accéder ; le résultat apparaît sur le formulaire avant que vous ne sauvegardiez. Ensuite Lancer ouvre SQLly avec ce profil dans un nouvel onglet.

  6. Ajoutez un utilisateur. Utilisateurs → Créer un utilisateur avec un nom d'utilisateur, un mot de passe et le profil. Ouvrez http://127.0.0.1:8090/ dans une fenêtre privée, connectez-vous en tant que cet utilisateur, et cliquez Ouvrir SQLly. C'est l'expérience que vos propres utilisateurs obtiennent.

De retour sur Statut vous verrez le siège qu'occupe désormais cet utilisateur. Fermez son onglet SQLly et il se libère.

Les paramètres dans .env

ParamètreÀ quoi ça sert
SQLLY_EMBEDDED_LICENSE_KEYUne clé de licence connectée (sqe_…). Laissez vide pour la lier depuis la page d'administration à la place.
SQLLY_EMBEDDED_LICENSE_FILEUn fichier de licence hors ligne. Ne définissez pas les deux.
SQLLY_EMBEDDED_MANAGE_TOKENLe secret partagé entre le pont et l'application d'administration. Généré au premier lancement.
SQLLY_EMBEDDED_DOMAINLe domaine depuis lequel votre application est servie. Laissez vide sur localhost. Le définir lie une licence non liée lors de la première vérification.
SQLLY_EMBEDDED_PUBLIC_URLLe wss://…/proxy URL que les navigateurs utilisent, une fois que vous êtes derrière un proxy inverse.
SQLLY_EMBEDDED_STATE_DIROù le pont garde les profils, le cache de licence et une clé liée.

Chaque indicateur du pont a une variable d'environnement ; la liste complète est sur Passer en production.

Ce qui est dans le paquet

CheminCe que c'est
bin/sqlly-bridgeLe pont SQLly ; sqlly-bridge embedded … est le mode que ce paquet utilise.
bin/sqlly-cliLe moteur que le pont démarre par session. Gardez-le à côté du pont.
web/La version navigateur de SQLly : index.html, boot.js, spill-worker.js, sqlly_browser.js, sqlly_browser_bg.wasm, sqlly2.svg. Indépendant de la plateforme.
sample-app/L'application exemple d'administration et de lancement. server.js est le routage, lib/bridge.js un client API de gestion complet, lib/credentials.js construit les documents d'identification.
start-sample.sh, start-sample.cmdDémarrez le pont et l'application exemple ensemble depuis .env.

Suivant

Faites le tour de l'application exemple pour voir chaque écran, ou allez directement à créer votre propre application.