Skip to Content
Getting StartedInstallation

Last Updated: 3/11/2026

This guide walks you through setting up LinkAce using Docker, the recommended installation method. You’ll have LinkAce running in minutes.

Requirements

  • Command-line access to your server
  • Docker version 19 or greater
  • Docker Compose (must support compose version 3)

Installation Steps

1. Download the setup files

Download the Docker setup package from the LinkAce repository:
linkace-docker.zip

Alternatively, grab the files directly:

2. Configure security settings

Open the .env file and change these two passwords:

DB_PASSWORD=ChangeThisToASecurePassword!
REDIS_PASSWORD=ChangeThisToASecurePassword!

Important: If you’re unsure whether the .env file is writable inside Docker, make it writable for all users (chmod 666 .env). You can revert this after setup completes.

Your directory should now look like this:

/linkace/
├── .env
├── docker-compose.yml
├── LICENSE.md
└── README.md

3. Start LinkAce

Run the following command to start all services:

docker compose up -d

This starts three containers:

  • app — LinkAce application (port 80)
  • db — MariaDB 12.0 database
  • redis — Redis 8.2 cache

4. Complete setup in your browser

Open your browser and navigate to:

  • http://localhost (if running locally)
  • Your domain or server IP (if running remotely)

Follow the built-in setup wizard to:

  1. Configure the database connection (already set via .env)
  2. Create your admin user account

5. Follow post-setup steps

After the wizard completes, visit First Steps to:

  • Add your first link
  • Understand the dashboard
  • Configure optional features (backups, monitoring)

Troubleshooting

Setup wizard doesn’t load
If the built-in setup fails, complete installation via CLI:

docker exec -it linkace_app_1 php artisan migrate
docker exec -it linkace_app_1 php artisan setup:complete
docker exec -it linkace_app_1 php artisan registeruser --admin

The last command creates your admin user. After completion, log in at your LinkAce URL.

Port 80 already in use
Edit docker-compose.yml and change the port mapping:

ports:
  - "8080:80"  # Access at http://localhost:8080

What’s Next

OverviewFirst Steps