Observera denna guide är för avancerade användare. Du förutsätts kunna använda Terminalen (antingen via cPanel eller genom en SSH-klient).
Det finns flera olika sätt att installera och köra Ghost. I den här guiden använder vi oss av ghost-cli samt nyttjar MySQL för databasen.
Ghost är en trevlig plattform (CMS) som kan användas för bland annat bloggar. Till skillnad från exempelvis WordPress så körs inte Ghost via PHP utan via Node.js. Installationsförfarandet är därför lite annorlunda mot klassiska PHP-plattformar. Den här guiden beskriver hur du installerar Ghost på ett webbhotellkonto hos oss.
Observera att vi inte har möjlighet att ge support på hur man använder Ghost.
Guiden är skriven för Ghost 5 och vi kan därför inte garantera att det fungerar för äldre eller kommande versioner.
Notera även att kommande major version kräver MySQL 8 vilket vi inte stödjer på våra webbhotellskonton men det går såklart att använda en extern databasserver.
Förberedelser
Innan du kan installera Ghost behöver du göra lite förberedelser på ditt webbhotellkonto. Du behöver dels sätta upp en MySQL-databas och tillhörande användare, och dels behöver du ordna med en domän att ha installationen på. Därtill kommer du behöva sätta upp en Node.js-applikation och installera ghost-cli.
Skapa en ny MySQL-databas och -användare
Följ den här guiden för att skapa databasen och notera användarnamn, databasnamn och lösenord då dessa används senare i guiden. Ge databasanvändaren fullständiga rättigheter på databasen.
Sätt upp den URL du vill köra Ghost på
I den här guiden kommer vi sätta upp Ghost på en underdomän, men det går lika bra att installera direkt på en specifik domän. I exemplet kommer vi använda domänen och dokumentroten i bilden nedan.
Förberedelserna är nu klara och vi kan gå vidare med att skapa en Node.js-applikation där Ghostinstallationen sedan kommer hamna.
Skapa en Node.js-app för Ghost via cPanel
Vi beskriver i den här guiden hur man skapar Node.js-applikationer via cPanel. Så följ den och sätt upp appen med följande inställningar (anpassade efter din domän/underdomän etc). Application root är valfri men vi lägger den här i en underkatalog i domänens dokumentrot.
- Version:
16.X - Application mode:
Development(Du kan ändra denna senare men notera då att Ghost läser ifrån en annan config-fil, se deras dokumentation här) - Application root:
domains/ghost.exempel.se/ghost - Application URL:
ghost.exempel.se(Domänen/underdomänen du ordnade tidigare.) - Application startup file:
ghost_lsnode.js(Vi kommer skapa denna själva för start via LiteSpeeds lsnode.)
I vårt fall ser inställningarna ut så här:
Klicka sedan på Create-knappen för att skapa applikationen.
Installera ghost-cli
När Node.js-applikationen har skapats kommer du få besked om det samt se ett kommando du kan använda för att komma åt Node.js-miljön via SSH eller Terminal. Klickar du på kommandot kommer det kopieras åt dig.
Klistra in kommandot i terminalen, ett antal variabler läses nu in och du hamnar i dokumentroten för din Node.js-applikation.
Kör nu följande kommando för att installera ghost-cli:
npm install -g ghost-cli
Det tar en stund för servern att installera alla delar av ghost-cli, så avvakta medan den jobbar på. Det tar normalt under en minut.
När ghost-cli är installerat behöver vi ta bort allt som Node.js-verktyget skapade automatiskt i appens katalog då Ghost installationen kräver att den är tom. Exempelvis med rm-kommandot enligt nedan.
[domains/ghost.exempel.se/ghost (16)] [exempel@iwarebiko ghost]$ rm -rf *
Mappen du står i, alltså roten för Node.js-applikationen, är nu tom och du är redo att installera Ghost!
Installera Ghost
För att köra installationen, kör nu följande kommando:
ghost install --no-setup-linux-user --no-setup-ssl --no-start --no-setup-nginx --no-setup-systemd
Under installationen kommer du behöva mata in URLen (https://ghost.exempel.se i detta exempel) för din Ghost-site samt dina databasuppgifter (från tidigare i den här guiden, nedan markerade med DATABASANVÄNDARNAMNET, DATABASANVÄNDARENS LÖSENORD samt DATABASENS NAMN). Nedan visar vi outputen från installationen, samt markerar de ställen där du behöver mata in något.
✔ Checking system Node.js version - found v16.20.1
✔ Checking current folder permissions
✔ Checking memory availability
✔ Checking free space
✔ Checking for latest Ghost version
✔ Setting up install directory
✔ Downloading and installing Ghost v5.55.2
✔ Finishing install process
? Enter your blog URL: https://ghost.exempel.se
? Enter your MySQL hostname: localhost
? Enter your MySQL username: DATABASANVÄNDARNAMNET
? Enter your MySQL password: DATABASANVÄNDARENS LÖSENORD
? Enter your Ghost database name: DATABASENS NAMN
✔ Configuring Ghost
✔ Setting up instance
ℹ Setting up "ghost" mysql user [skipped]
Ghost uses direct mail by default. To set up an alternative email method read our docs at https://ghost.org/docs/config/#mail
------------------------------------------------------------------------------
Ghost was installed successfully! To complete setup of your publication, visit:
https://ghost.exempel.se/ghost/
Nu är installationen nästan klar! Det som återstår är att skapa ghost_lsnode.js-filen som innehåller en rad för att lösa en bug med stdin i Node.js tillsammans med sockets som LiteSpeed använder för att skapa en automatisk proxy via webbservern. Du kan skapa filen snabbt med kommandot nedan, filens innehåll är de två raderna som är mellan EOF markörerna.
cat > ghost_lsnode.js << 'EOF'
process.stdin;
require('./current/ghost.js');
EOF
Avsluta installationen
Surfa nu till admindelen av din Ghost-installation (alltså Ghost-URLen med /ghost tillagd på slutet, i vårt exempel blir det https://ghost.exempel.se/ghost). Du kommer se ett meddelande likt det nedan. Detta visas under tiden som Ghost bygger upp databasstrukturen etc.
Om du avvaktar några minuter och sedan laddar om sidan kommer du komma fram till introduktionsguiden där du får skapa en adminanvändare. Följ instruktionerna på skärmen för att lägga till din användare. Du får även möjlighet att bjuda in andra till siten, exempelvis om ni är några stycken som ska arbeta med siten.
Installationen är nu klar och går att beskåda på URLen du valt! Det är nu upp till dig att ge sidan innehåll.
Uppdatera Ghost
Ghost som plattform uppdateras ganska ofta, och för att installera en uppdatering, gör så här:
Logga in på ditt konto via Terminalen/SSH och kör kommandot för att gå in i Ghost-miljön. Om du inte sparat kommandot kan du hitta det inne på cPanel via Setup Node.js app -> Edit (pennan) till höger om din applikation. Där ser du kommandot på samma sätt som under rubriken Installera ghost-cli i den här guiden.
Kör sedan följande kommando för att uppdatera Ghost till senaste versionen:
ghost update
Efter en liten stund ska du få besked om att Ghost är uppdaterats till senaste versionen.