Skip to content
Essentials

This installation is not finished

Here is what it still needs. Nothing on this page changes anything.

Run this on the host

It asks for what is missing, writes it down and runs what needs running. It is safe to run again.

php artisan essentials:install

To see this list from a terminal without changing anything:

php artisan essentials:install --check

Setup

  • PHP security updates

    Done

    Whether this PHP has the fixes for the critical holes known when this release was made.

  • Application key

    Done

    Everything encrypted here, including the panel credentials, is encrypted with it.

  • Writable storage

    Done

    The framework writes compiled views, logs and uploads into storage.

  • Database

    Done

    Accounts, plugins, panels and everything else live here.

  • Migrations

    Needed

    The tables the application expects to find.

    Run php artisan migrate --force --seed.

    51/52

  • Reference data

    Done

    The roles, the abilities and the languages the application ships with.

  • Session listing

    Done

    Lets somebody see which browsers they are signed in on and sign one out. It reads the sessions table, so it needs the database driver.

  • Cache

    Done

    Not only speed: the stored translations and the installed-state answer are read through it.

  • Redis

    Done

    Optional. Used only for what is pointed at it, and reported here when something is.

  • Frontend build

    Done

    The stylesheet and the script the pages load.

  • Built stylesheet and script

    Optional

    Whether public/build was built from the views, styles and scripts that are here.

    The release came with a build of other files. Run npm run build where the code is made and commit public/build, or build it here with essentials:update --no-code --frontend. Until then the stylesheet and script are missing whatever was added since, so a heading can render at the size of the body text and a button can do nothing.

  • Cached routes and config

    Optional

    Whether what is cached is older than the files it was built from, .env included.

    Run php artisan optimize. Until then the site serves the routes and settings it had before the last change, including values changed in .env since.

  • Discord sign-in

    Done

    Discord is the only way in. Nobody can sign in until it is configured.

  • Owner

    Done

    One Discord account holds every ability, and grants the rest. Without it the administration area stays closed to everybody.

  • Community server

    Done

    Adds somebody to the Discord server when they sign up, unless they clear the box. Needs a bot that is already in the server with permission to create invites.

  • GitHub

    Done

    Reads the plugin repositories and hands out the release archives. The site works without it; the catalogue does not fill itself.

The deployment notes have the whole procedure, including the queue worker and the scheduler.

Put Essentials on your home screen

Your browser can install it now. It opens in a window of its own, without the address bar, like any other app.