Cloudron makes it easy to run web apps like WordPress, Nextcloud, GitLab on your server. Find out more or install now.


Skip to content
  • Categories
  • Recent
  • Tags
  • Popular
  • Bookmarks
  • Search
Skins
  • Light
  • Brite
  • Cerulean
  • Cosmo
  • Flatly
  • Journal
  • Litera
  • Lumen
  • Lux
  • Materia
  • Minty
  • Morph
  • Pulse
  • Sandstone
  • Simplex
  • Sketchy
  • Spacelab
  • United
  • Yeti
  • Zephyr
  • Dark
  • Cyborg
  • Darkly
  • Quartz
  • Slate
  • Solar
  • Superhero
  • Vapor

  • Default (No Skin)
  • No Skin
Collapse
Brand Logo

Cloudron Forum

Apps | Demo | Docs | Install
  1. Cloudron Forum
  2. Discuss
  3. How to Setup LinkStack on Cloudron

How to Setup LinkStack on Cloudron

Scheduled Pinned Locked Moved Discuss
linkstacklinktreelittlelinktutorialcustom-apps
2 Posts 1 Posters 25 Views 1 Watching
  • Oldest to Newest
  • Newest to Oldest
  • Most Votes
Reply
  • Reply as topic
Log in to reply
This topic has been deleted. Only users with topic management privileges can see it.
  • L Offline
    L Offline
    LoudLemur
    wrote last edited by LoudLemur
    #1

    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

    1. Go to your Cloudron control panel at https://my.website.com
    2. Click "App Store"
    3. Search for "LAMP" and install it
    4. Set the location to https://linkstack.website.com
    5. 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

    1. SSH into your Cloudron server or use the LAMP file manager

    2. Navigate to the web directory:

      cd /app/data/public/
      
    3. Download LinkStack:

      wget https://github.com/LinkStackOrg/LinkStack/archive/refs/heads/main.zip -O linkstack.zip
      
    4. Extract directly on server:

      unzip linkstack.zip
      
    5. Move contents to web root:

      mv LinkStack-main/* .
      mv LinkStack-main/.* . 2>/dev/null
      rm -rf LinkStack-main/
      rm linkstack.zip
      
    6. 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 show www-data www-data

    Step 3: Complete Installation Wizard

    1. Visit https://linkstack.website.com
    2. 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

    1. Log into LinkStack admin panel
    2. Navigate to Config settings
    3. Find "Skip update backups" and set it to Enable
    4. 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

    1. Navigate to themes directory:

      cd /app/data/public/themes/
      
    2. 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
      
    3. Extract all themes:

      # Unzip all theme files
      for zip in *.zip; do
          if [ -f "$zip" ]; then
              echo "Extracting $zip"
              unzip -q "$zip"
          fi
      done
      
    4. 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
      
    5. 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

    1. Restart your LinkStack app in Cloudron
    2. Visit https://linkstack.website.com/admin
    3. Navigate to Themes section
    4. Verify all themes are available and displaying properly
    5. 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.

    1 Reply Last reply
    1
    • L Offline
      L Offline
      LoudLemur
      wrote last edited by LoudLemur
      #2

      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.zip

      We 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
      Copy

      Check 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

      1 Reply Last reply
      0
      • L LoudLemur referenced this topic
      Reply
      • Reply as topic
      Log in to reply
      • Oldest to Newest
      • Newest to Oldest
      • Most Votes


      • Login

      • Don't have an account? Register

      • Login or register to search.
      • First post
        Last post
      0
      • Categories
      • Recent
      • Tags
      • Popular
      • Bookmarks
      • Search