It only takes a few minutes to get Subvert up and running. Using Docker is the preferred method, but you can also build and run the application from source if you'd like.
Running the container
Subvert is self-contained in a single Docker image and can be started with a one-line command:
docker run -it -p 80:8080 -e OPENAI_API_KEY=sk-123abc aschmelyun/subvert
This will boot up a server running the application and make it available to your machine at http://localhost.
Want to have the application available at a different port? Change the first number after the
-p. For example,
8088:80will make the app available at localhost:8088
- PHP 8.1 or higher.
- Node.js version 16 or higher.
- Composer installed on the host machine.
Building the application
After cloning the repo, run the following commands to get the application's dependencies installed and assets compiled:
composer install npm install npm run build
Then, copy over the
.env.example file to
.env. You'll need to open up that file in your editor of choice and add a line to the bottom of it with your OpenAI API key.
Run the following commands to get a fresh key generated for the application and scaffold out the Sqlite database:
php artisan key:generate php artisan migrate:fresh --force
After that finishes up, you're ready to actually run Subvert. There's three separate commands that power the frontend, backend, and queue worker, so it's recommended to use something like supervisor to manage these processes.
php artisan queue:work php artisan serve --port=80
Now your application should be available at http://localhost.