Last Updated: 3/11/2026

Setup with SQLite

Table of Contents

By default, LinkAce requires using MySQL for the regular setup. To use SQLite, please follow the specific instructions below depending on whether you use Docker or not.

Setup with Docker

Follow the steps 1 and 2 of the Docker installation guide, and do not start the Docker setup now.

The database file needs to be created. You can do this by using the following command which assumes that the database file is located in the same directory as the docker-compose.yml file and is called database.sqlite:

database.sqlite touch database.sqlite chmod 0777 database.sqlite

To persist your SQLite database, add the following line to the volumes section in your docker-compose.yml file:

volumes `volumes:

• ./database.sqlite:/app/database/database.sqlite`

Replace DB_DATABASE=linkace with DB_DATABASE=/app/database/database.sqlite in your .env file and replace DB_CONNECTION=mysql with DB_CONNECTION=sqlite.
Additionally, add SETUP_COMPLETED=true to the .env file as LinkAce does not support Postgres in the built-in setup yet.
After that run the following command to prepare start the application:

DB_DATABASE=linkace DB_DATABASE=/app/database/database.sqlite .env DB_CONNECTION=mysql DB_CONNECTION=sqlite SETUP_COMPLETED=true docker-compose up -d docker exec -it linkace_app_1 php artisan key:generate docker exec -it linkace_app_1 php artisan migrate docker exec -it linkace_app_1 php artisan setup:complete

After that, generate a new admin account by running the following command. You will be asked for a username, email address and a password.

docker exec -it linkace_app_1 php artisan registeruser

You can now open LinkAce in your browser and should be able to use the application.

Setup without Docker

Follow the steps 1 to 4 of the regular installation guide, and do not start the built-in setup right now. The database file needs to be created, so run the following command:

touch database/database.sqlite

Replace DB_DATABASE=linkace with DB_DATABASE=/path-to-linkace/database/database.sqlite in your .env file and replace DB_CONNECTION=mysql with DB_CONNECTION=sqlite. After that run the following command to prepare the database:

DB_DATABASE=linkace DB_DATABASE=/path-to-linkace/database/database.sqlite .env DB_CONNECTION=mysql DB_CONNECTION=sqlite php artisan key:generate php artisan migrate php artisan setup:complete

After that, generate a new admin account by running the following command. You will be asked for a username, email address and a password.

php artisan registeruser

You can now open LinkAce in your browser and should be able to use the application.

Next Step: Post-Setup Steps

Table of Contents