Installing Wiki.js on CentOS 7



  • Wiki.js is a NodeBB based modern wiki that can be installed on nearly any OS. We will run through a simple install on CentOS 7.

    First we will need to find a way to upgrade to the latest version of the GIT libraries as CentOS 7 itself does not have a version recent enough for wiki.js.

    yum install https://centos7.iuscommunity.org/ius-release.rpm
    yum install git
    

    Next we need to install our prerequisites.

    Coming--- prerequisites
    

    Now we can install wiki.js itself.

    cd /opt
    mkdir wiki
    useradd wiki
    chown wiki:wiki wiki
    su - wiki
    cd /opt/wiki
    curl -sSo- https://wiki.js.org/install.sh | bash
    firewall-cmd --zone=public --add-port=4573/tcp
    node wiki configure 4573
    

    At this point we have our wiki running and we can continue to configure it via the web interface.



  • Now we can configure our wiki.js instance through the web GUI.

    0_1516421422838_Screenshot from 2018-01-19 20-47-00.png

    0_1516421434644_Screenshot from 2018-01-19 20-47-32.png

    0_1516421445558_Screenshot from 2018-01-19 20-48-31.png

    0_1516421455470_Screenshot from 2018-01-19 20-49-43.png

    0_1516421465471_Screenshot from 2018-01-19 20-50-26.png

    0_1516421477019_Screenshot from 2018-01-19 20-50-51.png

    0_1516421486254_Screenshot from 2018-01-19 20-51-07.png

    0_1516421496590_Screenshot from 2018-01-19 20-51-25.png

    0_1516421504433_Screenshot from 2018-01-19 20-51-46.png

    0_1516421512366_Screenshot from 2018-01-19 20-52-13.png

    0_1516421520047_Screenshot from 2018-01-19 20-53-05.png



  • At this point the wiki will restart and attempt to run itself in the normal mode rather than in configuration mode. For normal use cases, you will generally want to have a reverse proxy in front of your wiki.js instance. I won't cover how to configure Nginx here, but typically you will put Nginx in front of your Node instance running wiki.js. Because of this, wiki.js will be on a high range port, as used in the example, and Nginx will consume that port and will present wiki.js with SSL on port 443. The Node install with wiki.js does not itself handle SSL so having a reverse proxy is very important.



  • Why are people using CentOS for This? Nothing on their website says it has to be on this.



  • @jaredbusch said in Installing Wiki.js on CentOS 7:

    Why are people using CentOS for This? Nothing on their website says it has to be on this.

    Anyone using CentOS other than me? I'm using it because it is our existing standard platform for NodeJS deployments and we aren't moving from it anytime soon. I was asked to document my process, so I did. It should be even simpler to do it on Fedora, that's just not where I'm deploying right now.



  • @scottalanmiller said in Installing Wiki.js on CentOS 7:

    @jaredbusch said in Installing Wiki.js on CentOS 7:

    Why are people using CentOS for This? Nothing on their website says it has to be on this.

    Anyone using CentOS other than me? I'm using it because it is our existing standard platform for NodeJS deployments and we aren't moving from it anytime soon. I was asked to document my process, so I did. It should be even simpler to do it on Fedora, that's just not where I'm deploying right now.

    Yes, one other in another thread was talking about CentOS for some reason. While someone else said they used Ubuntu I believe.



  • @jaredbusch said in Installing Wiki.js on CentOS 7:

    @scottalanmiller said in Installing Wiki.js on CentOS 7:

    @jaredbusch said in Installing Wiki.js on CentOS 7:

    Why are people using CentOS for This? Nothing on their website says it has to be on this.

    Anyone using CentOS other than me? I'm using it because it is our existing standard platform for NodeJS deployments and we aren't moving from it anytime soon. I was asked to document my process, so I did. It should be even simpler to do it on Fedora, that's just not where I'm deploying right now.

    Yes, one other in another thread was talking about CentOS for some reason. While someone else said they used Ubuntu I believe.

    I used Ubuntu because it's what their documentation recommended.



  • @jaredbusch said in Installing Wiki.js on CentOS 7:

    @scottalanmiller said in Installing Wiki.js on CentOS 7:

    @jaredbusch said in Installing Wiki.js on CentOS 7:

    Why are people using CentOS for This? Nothing on their website says it has to be on this.

    Anyone using CentOS other than me? I'm using it because it is our existing standard platform for NodeJS deployments and we aren't moving from it anytime soon. I was asked to document my process, so I did. It should be even simpler to do it on Fedora, that's just not where I'm deploying right now.

    Yes, one other in another thread was talking about CentOS for some reason. While someone else said they used Ubuntu I believe.

    That was me. Its political reasons, nothing else.



  • @zachary715 said in Installing Wiki.js on CentOS 7:

    @jaredbusch said in Installing Wiki.js on CentOS 7:

    @scottalanmiller said in Installing Wiki.js on CentOS 7:

    @jaredbusch said in Installing Wiki.js on CentOS 7:

    Why are people using CentOS for This? Nothing on their website says it has to be on this.

    Anyone using CentOS other than me? I'm using it because it is our existing standard platform for NodeJS deployments and we aren't moving from it anytime soon. I was asked to document my process, so I did. It should be even simpler to do it on Fedora, that's just not where I'm deploying right now.

    Yes, one other in another thread was talking about CentOS for some reason. While someone else said they used Ubuntu I believe.

    I used Ubuntu because it's what their documentation recommended.

    Sort of, @wirestyle22 and I dug into that and while the docs say that, it's also pretty clear that they just don't update the docs, sadly. And they only document an install of Debian. They are all over the place. They don't exactly recommend old OSes like Ubuntu 16.04 and Windows 2012 R2, but point out that they are "more tested", which should be obvious since they are old. But that's not the same as recommended.

    "More tested" doesn't mean "more stable", already broken down old things are often better tested than new, reliable ones. A barely functional 1975 Pinto is "better tested" than a brand new BMW 335i, but the new BMW is probably less likely to leave you stranded.

    They word things a bit funny there and between that and not updating well, it can lead you in some weird directions. Not that Ubuntu is bad, but I don't think that they intend to recommend it in any way.



  • @scottalanmiller said in Installing Wiki.js on CentOS 7:

    @zachary715 said in Installing Wiki.js on CentOS 7:

    @jaredbusch said in Installing Wiki.js on CentOS 7:

    @scottalanmiller said in Installing Wiki.js on CentOS 7:

    @jaredbusch said in Installing Wiki.js on CentOS 7:

    Why are people using CentOS for This? Nothing on their website says it has to be on this.

    Anyone using CentOS other than me? I'm using it because it is our existing standard platform for NodeJS deployments and we aren't moving from it anytime soon. I was asked to document my process, so I did. It should be even simpler to do it on Fedora, that's just not where I'm deploying right now.

    Yes, one other in another thread was talking about CentOS for some reason. While someone else said they used Ubuntu I believe.

    I used Ubuntu because it's what their documentation recommended.

    Sort of, @wirestyle22 and I dug into that and while the docs say that, it's also pretty clear that they just don't update the docs, sadly. And they only document an install of Debian. They are all over the place. They don't exactly recommend old OSes like Ubuntu 16.04 and Windows 2012 R2, but point out that they are "more tested", which should be obvious since they are old. But that's not the same as recommended.

    "More tested" doesn't mean "more stable", already broken down old things are often better tested than new, reliable ones. A barely functional 1975 Pinto is "better tested" than a brand new BMW 335i, but the new BMW is probably less likely to leave you stranded.

    They word things a bit funny there and between that and not updating well, it can lead you in some weird directions. Not that Ubuntu is bad, but I don't think that they intend to recommend it in any way.

    Wiki.js runs on pretty much any platform that supports the requirements below. However, the following environments are recommended and more thoroughly tested:
    
    Ubuntu Server 16.04 LTS
    Windows Server 2012 R2
    

    I did not interpret that to mean that the OS itself was more tested, but rather that had tested Wiki.js on these OSes more so than others. They make it clear it can run on any system though. I just chose to go with what they had claimed to have tested for and it's worked out for me thus far.



  • @scottalanmiller said in Installing Wiki.js on CentOS 7:

    Wiki.js is a NodeBB based modern wiki that can be installed on nearly any OS. We will run through a simple install on CentOS 7.

    I think you meant NodeJS here...



  • @zachary715 said in Installing Wiki.js on CentOS 7:

    @scottalanmiller said in Installing Wiki.js on CentOS 7:

    Wiki.js is a NodeBB based modern wiki that can be installed on nearly any OS. We will run through a simple install on CentOS 7.

    I think you meant NodeJS here...

    Whoops, yes.



  • @zachary715 said in Installing Wiki.js on CentOS 7:

    @scottalanmiller said in Installing Wiki.js on CentOS 7:

    @zachary715 said in Installing Wiki.js on CentOS 7:

    @jaredbusch said in Installing Wiki.js on CentOS 7:

    @scottalanmiller said in Installing Wiki.js on CentOS 7:

    @jaredbusch said in Installing Wiki.js on CentOS 7:

    Why are people using CentOS for This? Nothing on their website says it has to be on this.

    Anyone using CentOS other than me? I'm using it because it is our existing standard platform for NodeJS deployments and we aren't moving from it anytime soon. I was asked to document my process, so I did. It should be even simpler to do it on Fedora, that's just not where I'm deploying right now.

    Yes, one other in another thread was talking about CentOS for some reason. While someone else said they used Ubuntu I believe.

    I used Ubuntu because it's what their documentation recommended.

    Sort of, @wirestyle22 and I dug into that and while the docs say that, it's also pretty clear that they just don't update the docs, sadly. And they only document an install of Debian. They are all over the place. They don't exactly recommend old OSes like Ubuntu 16.04 and Windows 2012 R2, but point out that they are "more tested", which should be obvious since they are old. But that's not the same as recommended.

    "More tested" doesn't mean "more stable", already broken down old things are often better tested than new, reliable ones. A barely functional 1975 Pinto is "better tested" than a brand new BMW 335i, but the new BMW is probably less likely to leave you stranded.

    They word things a bit funny there and between that and not updating well, it can lead you in some weird directions. Not that Ubuntu is bad, but I don't think that they intend to recommend it in any way.

    Wiki.js runs on pretty much any platform that supports the requirements below. However, the following environments are recommended and more thoroughly tested:
    
    Ubuntu Server 16.04 LTS
    Windows Server 2012 R2
    

    I did not interpret that to mean that the OS itself was more tested, but rather that had tested Wiki.js on these OSes more so than others. They make it clear it can run on any system though. I just chose to go with what they had claimed to have tested for and it's worked out for me thus far.

    To me, it seems better to stay away from Wiki.js until they take it more seriously.

    I don't really see any additional benefits to using it versus other solutions that seem to work better and offer more.



  • @tim_g said in Installing Wiki.js on CentOS 7:

    @zachary715 said in Installing Wiki.js on CentOS 7:

    @scottalanmiller said in Installing Wiki.js on CentOS 7:

    @zachary715 said in Installing Wiki.js on CentOS 7:

    @jaredbusch said in Installing Wiki.js on CentOS 7:

    @scottalanmiller said in Installing Wiki.js on CentOS 7:

    @jaredbusch said in Installing Wiki.js on CentOS 7:

    Why are people using CentOS for This? Nothing on their website says it has to be on this.

    Anyone using CentOS other than me? I'm using it because it is our existing standard platform for NodeJS deployments and we aren't moving from it anytime soon. I was asked to document my process, so I did. It should be even simpler to do it on Fedora, that's just not where I'm deploying right now.

    Yes, one other in another thread was talking about CentOS for some reason. While someone else said they used Ubuntu I believe.

    I used Ubuntu because it's what their documentation recommended.

    Sort of, @wirestyle22 and I dug into that and while the docs say that, it's also pretty clear that they just don't update the docs, sadly. And they only document an install of Debian. They are all over the place. They don't exactly recommend old OSes like Ubuntu 16.04 and Windows 2012 R2, but point out that they are "more tested", which should be obvious since they are old. But that's not the same as recommended.

    "More tested" doesn't mean "more stable", already broken down old things are often better tested than new, reliable ones. A barely functional 1975 Pinto is "better tested" than a brand new BMW 335i, but the new BMW is probably less likely to leave you stranded.

    They word things a bit funny there and between that and not updating well, it can lead you in some weird directions. Not that Ubuntu is bad, but I don't think that they intend to recommend it in any way.

    Wiki.js runs on pretty much any platform that supports the requirements below. However, the following environments are recommended and more thoroughly tested:
    
    Ubuntu Server 16.04 LTS
    Windows Server 2012 R2
    

    I did not interpret that to mean that the OS itself was more tested, but rather that had tested Wiki.js on these OSes more so than others. They make it clear it can run on any system though. I just chose to go with what they had claimed to have tested for and it's worked out for me thus far.

    To me, it seems better to stay away from Wiki.js until they take it more seriously.

    I don't really see any additional benefits to using it versus other solutions that seem to work better and offer more.

    It does seem like they are lax on testing



  • @wirestyle22 said in Installing Wiki.js on CentOS 7:

    @tim_g said in Installing Wiki.js on CentOS 7:

    @zachary715 said in Installing Wiki.js on CentOS 7:

    @scottalanmiller said in Installing Wiki.js on CentOS 7:

    @zachary715 said in Installing Wiki.js on CentOS 7:

    @jaredbusch said in Installing Wiki.js on CentOS 7:

    @scottalanmiller said in Installing Wiki.js on CentOS 7:

    @jaredbusch said in Installing Wiki.js on CentOS 7:

    Why are people using CentOS for This? Nothing on their website says it has to be on this.

    Anyone using CentOS other than me? I'm using it because it is our existing standard platform for NodeJS deployments and we aren't moving from it anytime soon. I was asked to document my process, so I did. It should be even simpler to do it on Fedora, that's just not where I'm deploying right now.

    Yes, one other in another thread was talking about CentOS for some reason. While someone else said they used Ubuntu I believe.

    I used Ubuntu because it's what their documentation recommended.

    Sort of, @wirestyle22 and I dug into that and while the docs say that, it's also pretty clear that they just don't update the docs, sadly. And they only document an install of Debian. They are all over the place. They don't exactly recommend old OSes like Ubuntu 16.04 and Windows 2012 R2, but point out that they are "more tested", which should be obvious since they are old. But that's not the same as recommended.

    "More tested" doesn't mean "more stable", already broken down old things are often better tested than new, reliable ones. A barely functional 1975 Pinto is "better tested" than a brand new BMW 335i, but the new BMW is probably less likely to leave you stranded.

    They word things a bit funny there and between that and not updating well, it can lead you in some weird directions. Not that Ubuntu is bad, but I don't think that they intend to recommend it in any way.

    Wiki.js runs on pretty much any platform that supports the requirements below. However, the following environments are recommended and more thoroughly tested:
    
    Ubuntu Server 16.04 LTS
    Windows Server 2012 R2
    

    I did not interpret that to mean that the OS itself was more tested, but rather that had tested Wiki.js on these OSes more so than others. They make it clear it can run on any system though. I just chose to go with what they had claimed to have tested for and it's worked out for me thus far.

    To me, it seems better to stay away from Wiki.js until they take it more seriously.

    I don't really see any additional benefits to using it versus other solutions that seem to work better and offer more.

    It does seem like they are lax on testing

    It's node so I don't think you will see much changing between platforms. VMware is running it on PhotonOS. I've run it on CentOS and Fedora and haven't had any issues. Small projects like this usually don't have time to test on a bunch of platforms. But again, since it's Node it should be fine on anything.



  • @stacksofplates said in Installing Wiki.js on CentOS 7:

    @wirestyle22 said in Installing Wiki.js on CentOS 7:

    @tim_g said in Installing Wiki.js on CentOS 7:

    @zachary715 said in Installing Wiki.js on CentOS 7:

    @scottalanmiller said in Installing Wiki.js on CentOS 7:

    @zachary715 said in Installing Wiki.js on CentOS 7:

    @jaredbusch said in Installing Wiki.js on CentOS 7:

    @scottalanmiller said in Installing Wiki.js on CentOS 7:

    @jaredbusch said in Installing Wiki.js on CentOS 7:

    Why are people using CentOS for This? Nothing on their website says it has to be on this.

    Anyone using CentOS other than me? I'm using it because it is our existing standard platform for NodeJS deployments and we aren't moving from it anytime soon. I was asked to document my process, so I did. It should be even simpler to do it on Fedora, that's just not where I'm deploying right now.

    Yes, one other in another thread was talking about CentOS for some reason. While someone else said they used Ubuntu I believe.

    I used Ubuntu because it's what their documentation recommended.

    Sort of, @wirestyle22 and I dug into that and while the docs say that, it's also pretty clear that they just don't update the docs, sadly. And they only document an install of Debian. They are all over the place. They don't exactly recommend old OSes like Ubuntu 16.04 and Windows 2012 R2, but point out that they are "more tested", which should be obvious since they are old. But that's not the same as recommended.

    "More tested" doesn't mean "more stable", already broken down old things are often better tested than new, reliable ones. A barely functional 1975 Pinto is "better tested" than a brand new BMW 335i, but the new BMW is probably less likely to leave you stranded.

    They word things a bit funny there and between that and not updating well, it can lead you in some weird directions. Not that Ubuntu is bad, but I don't think that they intend to recommend it in any way.

    Wiki.js runs on pretty much any platform that supports the requirements below. However, the following environments are recommended and more thoroughly tested:
    
    Ubuntu Server 16.04 LTS
    Windows Server 2012 R2
    

    I did not interpret that to mean that the OS itself was more tested, but rather that had tested Wiki.js on these OSes more so than others. They make it clear it can run on any system though. I just chose to go with what they had claimed to have tested for and it's worked out for me thus far.

    To me, it seems better to stay away from Wiki.js until they take it more seriously.

    I don't really see any additional benefits to using it versus other solutions that seem to work better and offer more.

    It does seem like they are lax on testing

    It's node so I don't think you will see much changing between platforms. VMware is running it on PhotonOS. I've run it on CentOS and Fedora and haven't had any issues.

    @scottalanmiller has similar things to say about it. I'm definitely going to give it a whirl



  • But if there are concerns about the platform, just run it in either Docker or LXC/LXD. Then it makes no difference at all.



  • @scottalanmiller Thanks for documenting this. Going to install again tomorrow on either Cent or fedora



  • @fuznutz04 said in Installing Wiki.js on CentOS 7:

    @scottalanmiller Thanks for documenting this. Going to install again tomorrow on either Cent or fedora

    Fedora is a snap.



  • @fuznutz04 said in Installing Wiki.js on CentOS 7:

    @scottalanmiller Thanks for documenting this. Going to install again tomorrow on either Cent or fedora

    Yeah @scottalanmiller himself would tell you to install it on Fedora. He's just using CentOS because "it is our existing standard platform for NodeJS deployments" as he said.



  • @wirestyle22 said in Installing Wiki.js on CentOS 7:

    @fuznutz04 said in Installing Wiki.js on CentOS 7:

    @scottalanmiller Thanks for documenting this. Going to install again tomorrow on either Cent or fedora

    Yeah @scottalanmiller himself would tell you to install it on Fedora. He's just using CentOS because "it is our existing standard platform for NodeJS deployments" as he said.

    I figured, as Fedora is the new "go to" around here.



  • @wirestyle22 said in Installing Wiki.js on CentOS 7:

    @fuznutz04 said in Installing Wiki.js on CentOS 7:

    @scottalanmiller Thanks for documenting this. Going to install again tomorrow on either Cent or fedora

    Yeah @scottalanmiller himself would tell you to install it on Fedora. He's just using CentOS because "it is our existing standard platform for NodeJS deployments" as he said.

    Exactly.



  • Very good job thanks !!! 😁
    Was very usefull for my work.

    I'm beginning with Linux admin and i have a problem after installation. If someone have a idea ?

    The installation Complete good, i havn't set SSL configuration and skip the Git configuration. But after the 30seconds waiting at the end. I have a error page in my web browser..

    Where can i find log about this error ?



  • @mikah67 said in Installing Wiki.js on CentOS 7:

    Very good job thanks !!! 😁
    Was very usefull for my work.

    I'm beginning with Linux admin and i have a problem after installation. If someone have a idea ?

    The installation Complete good, i havn't set SSL configuration and skip the Git configuration. But after the 30seconds waiting at the end. I have a error page in my web browser..

    Where can i find log about this error ?

    Start in /var/log/nginx



  • @scottalanmiller Thanks for reply.

    Given that i don't use SSL, i havn't install a web server such Apache or Nginx.

    I use just Node.js.

    The instalation step work fine (Mongodb connexion OK) It's after the 30seconds wait. after the auto-refresh i'v a error page 😒



  • @mikah67 said in Installing Wiki.js on CentOS 7:

    @scottalanmiller Thanks for reply.

    Given that i don't use SSL, i havn't install a web server such Apache or Nginx.

    I use just Node.js.

    The instalation step work fine (Mongodb connexion OK) It's after the 30seconds wait. after the auto-refresh i'v a error page 😒

    Oh, that's going to be a lot more tricky.

    In your wiki.js deployment directory, there should be a logs directory. Check wiki-error-0.log in there.



  • @scottalanmiller

    Yep i have nothing in the "wiki-error-0.log" the files is empty.



  • @mikah67

    Hmm i have progress 😆

    When i try a other port in the configuration (tcp/8080) i have a other result. But..

    0_1521044767735_Capture du 2018-03-14 17-25-42.png image url)

    The language is french 😆

    I search next.

    Thanks for help



  • That looks like it is running fine, but likely you are using an IP address and it was configured for a URL or vice versa. It's not picking up the images.



  • @scottalanmiller Yep, i have use now a dns for connect me.

    When i let the port 80 in configuration i have the same issue.

    When i use the port 8080 in configuration it's works ! But when i change a page, it's redirect at port 80.. And i need te insert manually the port 8080 in the url.

    I suppose it's a problem with the redirect and or node.js (Version v6.12.3).

    I will try to reinstall it 🙂