Undefined table, relation "jobs" does not exist.

[thallgren]

I followed the instructions to install the self-hosting example "Docker + Database". I get this in the output log.

app-1 | 
app-1 | INFO Server running…. 
app-1 | 
app-1 | 
queue-1 | ^ (Connection: pgsql, SQL: select * from "jobs" where "queue" = default and (("reserved_at" is null and "available_at" <= 1765364803) or ("reserved_at" <= 1765364713)) order by "id" asc limit 1 FOR UPDATE SKIP LOCKED){"exception":"[object] (Illuminate\\Database\\QueryException(code: 42P01): SQLSTATE[42P01]: Undefined table: 7 ERROR: relation \"jobs\" does not exist

and after that, the logs get spammed with exceptions like this:

<pre><font color="#06989A">queue-1 | </font>[previous exception] [object] (PDOException(code: 42P01): SQLSTATE[42P01]: Undefined table: 7 ERROR: relation \&quot;jobs\&quot; does not exist
<font color="#06989A">queue-1 | </font>LINE 1: select * from \&quot;jobs\&quot; where \&quot;queue\&quot; = $1 and ((\&quot;reserved_at\&quot; ...
<font color="#06989A">queue-1 | </font> ^ at /var/www/html/vendor/laravel/framework/src/Illuminate/Database/Connection.php:409)
<font color="#06989A">queue-1 | </font>[stacktrace]
<font color="#06989A">queue-1 | </font>#0 /var/www/html/vendor/laravel/framework/src/Illuminate/Database/Connection.php(409): PDOStatement-&gt;execute()
<font color="#06989A">queue-1 | </font>#1 /var/www/html/vendor/laravel/framework/src/Illuminate/Database/Connection.php(809): Illuminate\\Database\\Connection-&gt;Illuminate\\Database\\{closure}()
<font color="#06989A">queue-1 | </font>#2 /var/www/html/vendor/laravel/framework/src/Illuminate/Database/Connection.php(776): Illuminate\\Database\\Connection-&gt;runQueryCallback()
<font color="#06989A">queue-1 | </font>#3 /var/www/html/vendor/tpetry/laravel-postgresql-enhanced/src/PostgresEnhancedConnection.php(206): Illuminate\\Database\\Connection-&gt;run()
<font color="#06989A">queue-1 | </font>#4 /var/www/html/vendor/laravel/framework/src/Illuminate/Database/Connection.php(395): Tpetry\\PostgresqlEnhanced\\PostgresEnhancedConnection-&gt;run()
<font color="#06989A">queue-1 | </font>#5 /var/www/html/vendor/laravel/framework/src/Illuminate/Database/Query/Builder.php(3131): Illuminate\\Database\\Connection-&gt;select()
<font color="#06989A">queue-1 | </font>#6 /var/www/html/vendor/laravel/framework/src/Illuminate/Database/Query/Builder.php(3116): Illuminate\\Database\\Query\\Builder-&gt;runSelect()
<font color="#06989A">queue-1 | </font>#7 /var/www/html/vendor/laravel/framework/src/Illuminate/Database/Query/Builder.php(3706): Illuminate\\Database\\Query\\Builder-&gt;Illuminate\\Database\\Query\\{closure}()
<font color="#06989A">queue-1 | </font>#8 /var/www/html/vendor/laravel/framework/src/Illuminate/Database/Query/Builder.php(3115): Illuminate\\Database\\Query\\Builder-&gt;onceWithColumns()
<font color="#06989A">queue-1 | </font>#9 /var/www/html/vendor/laravel/framework/src/Illuminate/Database/Concerns/BuildsQueries.php(366): Illuminate\\Database\\Query\\Builder-&gt;get()
<font color="#06989A">queue-1 | </font>#10 /var/www/html/vendor/laravel/framework/src/Illuminate/Queue/DatabaseQueue.php(308): Illuminate\\Database\\Query\\Builder-&gt;first()
<font color="#06989A">queue-1 | </font>#11 /var/www/html/vendor/laravel/framework/src/Illuminate/Queue/DatabaseQueue.php(286): Illuminate\\Queue\\DatabaseQueue-&gt;getNextAvailableJob()
<font color="#06989A">queue-1 | </font>#12 /var/www/html/vendor/laravel/framework/src/Illuminate/Database/Concerns/ManagesTransactions.php(32): Illuminate\\Queue\\DatabaseQueue-&gt;Illuminate\\Queue\\{closure}()
<font color="#06989A">queue-1 | </font>#13 /var/www/html/vendor/laravel/framework/src/Illuminate/Queue/DatabaseQueue.php(285): Illuminate\\Database\\Connection-&gt;transaction()
<font color="#06989A">queue-1 | </font>#14 /var/www/html/vendor/laravel/framework/src/Illuminate/Queue/Worker.php(353): Illuminate\\Queue\\DatabaseQueue-&gt;pop()
<font color="#06989A">queue-1 | </font>#15 /var/www/html/vendor/laravel/framework/src/Illuminate/Queue/Worker.php(368): Illuminate\\Queue\\Worker-&gt;Illuminate\\Queue\\{closure}()
<font color="#06989A">queue-1 | </font>#16 /var/www/html/vendor/laravel/framework/src/Illuminate/Queue/Worker.php(166): Illuminate\\Queue\\Worker-&gt;getNextJob()
<font color="#06989A">queue-1 | </font>#17 /var/www/html/vendor/laravel/framework/src/Illuminate/Queue/Console/WorkCommand.php(148): Illuminate\\Queue\\Worker-&gt;daemon()
<font color="#06989A">queue-1 | </font>#18 /var/www/html/vendor/laravel/framework/src/Illuminate/Queue/Console/WorkCommand.php(131): Illuminate\\Queue\\Console\\WorkCommand-&gt;runWorker()
<font color="#06989A">queue-1 | </font>#19 /var/www/html/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(36): Illuminate\\Queue\\Console\\WorkCommand-&gt;handle()
<font color="#06989A">queue-1 | </font>#20 /var/www/html/vendor/laravel/framework/src/Illuminate/Container/Util.php(43): Illuminate\\Container\\BoundMethod::Illuminate\\Container\\{closure}()
<font color="#06989A">queue-1 | </font>#21 /var/www/html/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(96): Illuminate\\Container\\Util::unwrapIfClosure()
<font color="#06989A">queue-1 | </font>#22 /var/www/html/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(35): Illuminate\\Container\\BoundMethod::callBoundMethod()
<font color="#06989A">queue-1 | </font>#23 /var/www/html/vendor/laravel/framework/src/Illuminate/Container/Container.php(754): Illuminate\\Container\\BoundMethod::call()
<font color="#06989A">queue-1 | </font>#24 /var/www/html/vendor/laravel/framework/src/Illuminate/Console/Command.php(211): Illuminate\\Container\\Container-&gt;call()
<font color="#06989A">queue-1 | </font>#25 /var/www/html/vendor/symfony/console/Command/Command.php(318): Illuminate\\Console\\Command-&gt;execute()
<font color="#06989A">queue-1 | </font>#26 /var/www/html/vendor/laravel/framework/src/Illuminate/Console/Command.php(180): Symfony\\Component\\Console\\Command\\Command-&gt;run()
<font color="#06989A">queue-1 | </font>#27 /var/www/html/vendor/symfony/console/Application.php(1092): Illuminate\\Console\\Command-&gt;run()
<font color="#06989A">queue-1 | </font>#28 /var/www/html/vendor/symfony/console/Application.php(341): Symfony\\Component\\Console\\Application-&gt;doRunCommand()
<font color="#06989A">queue-1 | </font>#29 /var/www/html/vendor/symfony/console/Application.php(192): Symfony\\Component\\Console\\Application-&gt;doRun()
<font color="#06989A">queue-1 | </font>#30 /var/www/html/vendor/laravel/framework/src/Illuminate/Foundation/Console/Kernel.php(197): Symfony\\Component\\Console\\Application-&gt;run()
<font color="#06989A">queue-1 | </font>#31 /var/www/html/artisan(35): Illuminate\\Foundation\\Console\\Kernel-&gt;handle()
<font color="#06989A">queue-1 | </font>#32{main}
<font color="#06989A">queue-1 | </font>&quot} 
</pre>

[thallgren]

The above messages happen in Step 4 of the instruction. In Step 5 (Migrate database), the table is apparently created, so this issue is more about documentation.

Suggestion:

• Add a "Create database" (not "Migrate", because the user has no data to migrate at this point) in step 4, before suggesting that the user starts monitoring the logs.
• Write a note to the user, explaining that errors will be generated in the logs until the database tables have been created.