How to Setup LinkStack on Cloudron
-
How to Setup LinkStack on Cloudron
A complete guide to installing LinkStack using Cloudron's LAMP app with all available themes
Key Points to Remember
- Never unzip LinkStack locally - always extract directly on the server to avoid 500 errors
- Extract contents to web root - move files out of subfolders into
/app/data/public/
- Fix ownership - ensure all files are owned by
www-data:www-data
- Disable automatic backups before installing themes
- The
type_params
column should already exist in modern LinkStack versions - Themes are hosted separately from the main LinkStack repository
Step-by-Step Installation
Step 1: Install LAMP App
- Go to your Cloudron control panel at
https://my.website.com
- Click "App Store"
- Search for "LAMP" and install it
- Set the location to
https://linkstack.website.com
- Wait for installation to complete
Troubleshooting:
- If DNS doesn't resolve immediately, wait 5-10 minutes for propagation
- Ensure your domain is properly configured in Cloudron
Step 2: Download and Extract LinkStack
-
SSH into your Cloudron server or use the LAMP file manager
-
Navigate to the web directory:
cd /app/data/public/
-
Download LinkStack:
wget https://github.com/LinkStackOrg/LinkStack/archive/refs/heads/main.zip -O linkstack.zip
-
Extract directly on server:
unzip linkstack.zip
-
Move contents to web root:
mv LinkStack-main/* . mv LinkStack-main/.* . 2>/dev/null rm -rf LinkStack-main/ rm linkstack.zip
-
Fix ownership:
chown -R www-data:www-data .
Troubleshooting:
- If you see a 500 error, you likely unzipped locally - start over with server extraction
- If files aren't loading, check that
index.php
exists in/app/data/public/
- Verify ownership with
ls -la
- all files should showwww-data www-data
Step 3: Complete Installation Wizard
- Visit
https://linkstack.website.com
- Follow the installation wizard:
- Choose SQLite for simplicity
- Create your admin account
- Configure basic settings
Troubleshooting:
- If you still see the LAMP welcome page, restart the app and wait a few minutes
- Check that
.env
file exists and has proper configuration - Ensure the
storage
directory has write permissions
Step 4: Configure for Theme Installation
- Log into LinkStack admin panel
- Navigate to Config settings
- Find "Skip update backups" and set it to Enable
- Click "Apply changes"
Troubleshooting:
- If you can't find backup settings, look under Advanced or System settings
- Ensure you're logged in as an admin user
Step 5: Install All Available Themes
-
Navigate to themes directory:
cd /app/data/public/themes/
-
Download all official themes:
# LinkStackOrg themes wget https://github.com/linkstackorg/mono/archive/refs/heads/main.zip -O mono.zip wget https://github.com/linkstackorg/stargazer/archive/refs/heads/main.zip -O stargazer.zip wget https://github.com/linkstackorg/minceraft/archive/refs/heads/main.zip -O minceraft.zip wget https://github.com/linkstackorg/bean-soup/archive/refs/heads/main.zip -O bean-soup.zip wget https://github.com/linkstackorg/SoT/archive/refs/heads/main.zip -O SoT.zip wget https://github.com/linkstackorg/winter-wonderland/archive/refs/heads/main.zip -O winter-wonderland.zip wget https://github.com/linkstackorg/flare/archive/refs/heads/main.zip -O flare.zip wget https://github.com/linkstackorg/Magic-Kingdom/archive/refs/heads/main.zip -O Magic-Kingdom.zip wget https://github.com/linkstackorg/Dark/archive/refs/heads/main.zip -O Dark.zip wget https://github.com/linkstackorg/Aurora/archive/refs/heads/main.zip -O Aurora.zip wget https://github.com/linkstackorg/llc-vanilla/archive/refs/heads/main.zip -O llc-vanilla.zip wget https://github.com/linkstackorg/sublime/archive/refs/heads/main.zip -O sublime.zip wget https://github.com/linkstackorg/Dawn/archive/refs/heads/main.zip -O Dawn.zip wget https://github.com/linkstackorg/polygon/archive/refs/heads/main.zip -O polygon.zip wget https://github.com/linkstackorg/Bongo-Cat/archive/refs/heads/main.zip -O Bongo-Cat.zip wget https://github.com/linkstackorg/isaac/archive/refs/heads/main.zip -O isaac.zip wget https://github.com/linkstackorg/Misty-Rain/archive/refs/heads/main.zip -O Misty-Rain.zip wget https://github.com/linkstackorg/Cloudy-Storm/archive/refs/heads/main.zip -O Cloudy-Storm.zip # Nekosheen themes wget https://github.com/nekosheen/Rainbow/archive/refs/heads/main.zip -O Rainbow.zip wget https://github.com/nekosheen/Soothing/archive/refs/heads/main.zip -O Soothing.zip wget https://github.com/nekosheen/PaperBold/archive/refs/heads/main.zip -O PaperBold.zip
-
Extract all themes:
# Unzip all theme files for zip in *.zip; do if [ -f "$zip" ]; then echo "Extracting $zip" unzip -q "$zip" fi done
-
Rename theme folders properly:
# Remove "-main" suffix from folder names for dir in *-main; do if [ -d "$dir" ]; then newname=$(echo "$dir" | sed 's/-main$//') mv "$dir" "$newname" echo "Renamed $dir to $newname" fi done
-
Clean up and fix ownership:
rm *.zip chown -R www-data:www-data .
Troubleshooting:
- If themes show as duplicates, check folder names are correct (no
-main
suffix) - If thumbnails don't load, restart the LinkStack app
- Verify each theme folder contains proper theme files
- Check that all folders are owned by
www-data:www-data
Step 6: Final Configuration
- Restart your LinkStack app in Cloudron
- Visit
https://linkstack.website.com/admin
- Navigate to Themes section
- Verify all themes are available and displaying properly
- Choose your preferred theme and customize your profile
Troubleshooting:
- If themes aren't showing, clear browser cache and restart the app
- Check
/app/data/public/themes/
contains all theme folders - Ensure each theme folder has the correct internal structure
Success Checklist
- LinkStack loads at your domain
- Admin panel is accessible
- All themes are visible in theme selector
- Themes display proper names and thumbnails
- Database is working (can create/edit links)
- File permissions are correct (
www-data:www-data
)
Available Themes
Your installation will include all official themes:
LinkStackOrg Themes: mono, stargazer, minceraft, bean-soup, SoT, winter-wonderland, flare, Magic-Kingdom, Dark, Aurora, llc-vanilla, sublime, Dawn, polygon, Bongo-Cat, isaac, Misty-Rain, Cloudy-Storm
Nekosheen Themes: Rainbow, Soothing, PaperBold
Plus the default themes: PolySleek, Galaxy
Common Issues
500 Internal Server Error: Files were unzipped locally instead of on server - re-extract on server
Themes not showing: Check folder names, ownership, and restart the app
Database errors: Modern LinkStack should work out of the box, but if needed:
ALTER TABLE links ADD COLUMN type_params TEXT DEFAULT NULL;
LAMP welcome page still showing: Files aren't in correct location - ensure
index.php
is in/app/data/public/
This guide ensures a complete LinkStack installation with all available themes on Cloudron's LAMP stack. Follow each step carefully and use the troubleshooting sections if you encounter issues.
-
As of 2025-08-07, here are the links to download all the Linkstack community themes:
wget https://github.com/linkstackorg/mono/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/galaxy/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/stargazer/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/minceraft/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/bean-soup/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/SoT/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/winter-wonderland/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/flare/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/Magic-Kingdom/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/Dark/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/Aurora/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/llc-vanilla/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/sublime/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/Dawn/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/polygon/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/PolySleek/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/Bongo-Cat/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/isaac/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/Misty-Rain/archive/refs/heads/main.zip
wget https://github.com/linkstackorg/Cloudy-Storm/archive/refs/heads/main.zip
wget https://github.com/nekosheen/Rainbow/archive/refs/heads/main.zip
wget https://github.com/nekosheen/Soothing/archive/refs/heads/main.zip
wget https://github.com/nekosheen/PaperBold/archive/refs/heads/main.zipWe found the linkstack application to be quite slow once it had been installed. For example, switching between one page and another in the admin panel took a while.
What do you think is the cause?
Common Causes of Slow Performance:
PHP-FPM/Apache configuration - Default LAMP settings may be conservative
Laravel framework overhead - LinkStack is built on Laravel which can be resource-heavy
Database queries - SQLite can be slower than MySQL for complex operations
Missing PHP opcache - PHP isnβt caching compiled code
Resource limits - LAMP app may have CPU/memory constraints
Quick Performance Improvements:
Option 1: Switch to MySQL (Faster than SQLite)
In your LinkStack admin:
Database settings β Switch from SQLite to MySQL
Use the credentials from /app/data/credentials.txt
Option 2: Enable PHP Optimizations
If you can access the LAMP configuration:
bash
CopyCheck if opcache is enabled
php -m | grep -i opcache
Option 3: Increase LAMP Resources
In Cloudron:
Go to your LinkStack (LAMP) app settings
Increase memory limit if available
Check resource usage in the app dashboard -