How to deploy LumeCMS in a VPS

  1. Get a VPS from Hetzner, Digital Ocean, or similar service.

    • This script was tested only on Ubuntu 24.04.
  2. Create an A record in the DNS settings of your domain to the server IP. For example, cms.example.com.

  3. Log in from SSH and run:

    curl https://lumeland.github.io/cms-deploy/install.sh > install.sh && sh install.sh
  4. After updating and installing some packages, the script will ask you for some info:

    • The SSH URL of the repository. Example: git@github.com:user/repo.git.
    • An email. It's used for git commits, or to create the SSL certificate.
    • The domain for the CMS: cms.example.com.
    • An username. It's used to login in the CMS. By default is admin.
    • A password. Used for the login.
    • When generating the public/private rsa key pair, leave the passphrase empty.
    • During the process, it will ask you to add a deploy key.
      • Go to the GitHub respository / Settings / Deploy keys / Add deploy key.
      • Paste the key printed in the terminal.
      • Make sure to check "Allow write access".
      • Once the key is added, press Enter in the terminal to continue.
  5. When the script is finished you should see your site and be able to edit the pages.