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
  • 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. App Wishlist
  3. Hugo CMS

Hugo CMS

Scheduled Pinned Locked Moved App Wishlist
28 Posts 11 Posters 4.1k Views 12 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.
    • robiR Offline
      robiR Offline
      robi
      wrote on last edited by
      #10

      It's better coupled with a Front End app than can maybe aggregate content via RSS or other scripted automation, then generate the pages via Hugo/Jekyll/.../etc to wherever you need.

      Conscious tech

      1 Reply Last reply
      0
      • fbartelsF Offline
        fbartelsF Offline
        fbartels
        App Dev
        wrote on last edited by
        #11

        My blog (served through the surfer app) is built with Hugo. I was briefly looking at modifying the Github pages app, but for me it was a bit strange that I then would also need to store the source repo for the homepage inside of the app (I already have Gitea for this).

        I have now setup a ci flow with Drone (managing app running on Cloudron as well, agents running elsewhere). Only downside is that the surfer cli is quite slow for lots of small files, uploading my page currently takes 15 minutes.

        robiR 1 Reply Last reply
        0
        • fbartelsF fbartels

          My blog (served through the surfer app) is built with Hugo. I was briefly looking at modifying the Github pages app, but for me it was a bit strange that I then would also need to store the source repo for the homepage inside of the app (I already have Gitea for this).

          I have now setup a ci flow with Drone (managing app running on Cloudron as well, agents running elsewhere). Only downside is that the surfer cli is quite slow for lots of small files, uploading my page currently takes 15 minutes.

          robiR Offline
          robiR Offline
          robi
          wrote on last edited by
          #12

          @fbartels can you rework the CI to tar first then untar in surfer? not sure tar is available inside the container.

          Conscious tech

          fbartelsF 1 Reply Last reply
          0
          • robiR robi

            @fbartels can you rework the CI to tar first then untar in surfer? not sure tar is available inside the container.

            fbartelsF Offline
            fbartelsF Offline
            fbartels
            App Dev
            wrote on last edited by
            #13

            @robi yes, that is also how I am publishing another static app (Homer), but that would require breaking up the deploy process into individual commands (as opposed to the simple surfer put --token $SURFTOKEN --server blog.9wd.eu public/. /.

            1 Reply Last reply
            0
            • robiR Offline
              robiR Offline
              robi
              wrote on last edited by
              #14

              Then surfer needs a pipelining upgrade for the transfer of files in one go.

              From the shell we can pipe tar - over the network which could be as simple as that.

              Conscious tech

              1 Reply Last reply
              1
              • nebulonN Offline
                nebulonN Offline
                nebulon
                Staff
                wrote on last edited by
                #15

                I am about to finish a surfer sync <src> <dest> feature to be used in such pipelines to update the files. I hope that would work there then.

                fbartelsF 1 Reply Last reply
                2
                • nebulonN nebulon

                  I am about to finish a surfer sync <src> <dest> feature to be used in such pipelines to update the files. I hope that would work there then.

                  fbartelsF Offline
                  fbartelsF Offline
                  fbartels
                  App Dev
                  wrote on last edited by
                  #16

                  thanks @nebulon. Not quite sure if it would help in my case, since the page is rebuilt in a clean environment each time, so while the content may be the same, at least timestamps will have changed.

                  nebulonN 1 Reply Last reply
                  0
                  • ? A Former User

                    Hugo would be great but I do agree that static site generators are an odd ask given that surfer or GitHub pages steps to use Hugo could be used to, as I like to say, “document the problem away”

                    jdaviescoatesJ Offline
                    jdaviescoatesJ Offline
                    jdaviescoates
                    wrote on last edited by
                    #17

                    @atrilahiji said in Hugo CMS:

                    “document the problem away”

                    Yes, I think this is probably the answer. If there was a good step by step guide for beginners as to how to get started with this static site stuff then people could just do it. 🙂

                    What I want is a nice self-hosted documentation site that people can "click to edit this page on GitLab/ Gitea/ Gogs" like lots of people already do GitHub pages and Github. or with Gitbook.

                    The impression I get is that this really shouldn't be that hard to do using Surfer together with one of the Git apps on Cloudron (and/ or GitHub Pages), but I'm still not really sure where to start 🙂

                    Perhaps I should spend less time on this forum and more time reading up about it all! Then I could help write the guide! 😛 that might happen eventually! 🙂

                    I use Cloudron with Gandi & Hetzner

                    1 Reply Last reply
                    0
                    • fbartelsF fbartels

                      thanks @nebulon. Not quite sure if it would help in my case, since the page is rebuilt in a clean environment each time, so while the content may be the same, at least timestamps will have changed.

                      nebulonN Offline
                      nebulonN Offline
                      nebulon
                      Staff
                      wrote on last edited by
                      #18

                      @fbartels That is indeed true, I was thinking of adding checksum tests though, but for now the sync already helps to purge files on the remote end, which don't exist anymore in a new build. Of course if the pipeline is used to build artifacts or packages, then the old surfer put should be used to not purge the old ones

                      fbartelsF 1 Reply Last reply
                      0
                      • nebulonN nebulon

                        @fbartels That is indeed true, I was thinking of adding checksum tests though, but for now the sync already helps to purge files on the remote end, which don't exist anymore in a new build. Of course if the pipeline is used to build artifacts or packages, then the old surfer put should be used to not purge the old ones

                        fbartelsF Offline
                        fbartelsF Offline
                        fbartels
                        App Dev
                        wrote on last edited by
                        #19

                        @nebulon I noticed that in newer surfer version you added some parallelization for put requests. Upgrading surfer to the lastest version brought the deployment time down to four minutes.

                        1 Reply Last reply
                        3
                        • jdaviescoatesJ jdaviescoates

                          @girish this sounds/ looks really easy, but for someone like me I'm still not really sure how to do it.

                          Even though I've run Linux since before Ubuntu existed (and Ubuntu since it has), and I'm fairly familiar with using the command line for basic tasks, I still don't really feel at home there and have never really used git.

                          But I'd love to proper step-by-step guide to using things like Hugo, GitHub pages, mkDocs etc with Surfer on Cloudron.

                          I'm sure I could do it and would likely find it suprisingly and satisfyingly easy once I know how, but e.g. right now I'm not even sure where I'd type the above commands? On my local machine? after ssh-ing into my VPS? in a Cloudron web terminal? See what I mean? 🙂

                          V Offline
                          V Offline
                          vjvanjungg
                          wrote on last edited by
                          #20

                          @jdaviescoates check out my new guide https://forum.cloudron.io/topic/4042/beginner-s-guide-hugo-gitlab-ci-surfer hope it helps you get up and running. 😄

                          doodlemania2D 1 Reply Last reply
                          4
                          • V vjvanjungg

                            @jdaviescoates check out my new guide https://forum.cloudron.io/topic/4042/beginner-s-guide-hugo-gitlab-ci-surfer hope it helps you get up and running. 😄

                            doodlemania2D Offline
                            doodlemania2D Offline
                            doodlemania2
                            App Dev
                            wrote on last edited by
                            #21

                            @vjvanjungg Very nicely done!

                            1 Reply Last reply
                            1
                            • timconsidineT Offline
                              timconsidineT Offline
                              timconsidine
                              App Dev
                              wrote on last edited by timconsidine
                              #22

                              Sorry to revisit this old topic
                              Fully appreciate about static site generators building locally and push-publishing remotely.

                              But there’s an element to the discussion missing. In my case, I don’t want to be building locally. Then I am tied to a specific local device. It may not be to hand (and maybe too lazy to levitate posterior from sofa).

                              Yes, I could sync local configs between devices, but that’s not always smooth.

                              I would prefer to use a cloud resource to build and publish. If I am working in the terminal locally, no different to working in terminal remotely.
                              Yes, I could setup a remote deployment of a Linux desktop, use that to build and publish to eg Surfer. But why the duplication ? Seems more elegant and contained to be able to do it in one place.

                              I know this is contrary to the CI/CD bandwagon. But I see a lot of advantages, principally avoiding multiple component pieces.

                              girishG 1 Reply Last reply
                              0
                              • timconsidineT timconsidine

                                Sorry to revisit this old topic
                                Fully appreciate about static site generators building locally and push-publishing remotely.

                                But there’s an element to the discussion missing. In my case, I don’t want to be building locally. Then I am tied to a specific local device. It may not be to hand (and maybe too lazy to levitate posterior from sofa).

                                Yes, I could sync local configs between devices, but that’s not always smooth.

                                I would prefer to use a cloud resource to build and publish. If I am working in the terminal locally, no different to working in terminal remotely.
                                Yes, I could setup a remote deployment of a Linux desktop, use that to build and publish to eg Surfer. But why the duplication ? Seems more elegant and contained to be able to do it in one place.

                                I know this is contrary to the CI/CD bandwagon. But I see a lot of advantages, principally avoiding multiple component pieces.

                                girishG Offline
                                girishG Offline
                                girish
                                Staff
                                wrote on last edited by girish
                                #23

                                @timconsidine afaik, hugo is a CLI tool. One has to write a web application that you ask for - something which accepts git pushes or accepts uploads or monitors some git repo etc and then builds via hugo.

                                To be fair, this is what we did with GitHub Pages app . It runs jekyll and accepts git pushes (but only via http)

                                timconsidineT 1 Reply Last reply
                                0
                                • girishG girish

                                  @timconsidine afaik, hugo is a CLI tool. One has to write a web application that you ask for - something which accepts git pushes or accepts uploads or monitors some git repo etc and then builds via hugo.

                                  To be fair, this is what we did with GitHub Pages app . It runs jekyll and accepts git pushes (but only via http)

                                  timconsidineT Offline
                                  timconsidineT Offline
                                  timconsidine
                                  App Dev
                                  wrote on last edited by
                                  #24

                                  @girish hugo is CLI for building and outputting the built files.
                                  Totally happy with building the site pages in terminal, rendering them in Hugo, using webserver to serve.
                                  I just want to do it all in one container, without CI/CD, cloning repos, pushing files.
                                  Maybe I will try a custom image based on Surfer.

                                  robiR girishG 2 Replies Last reply
                                  1
                                  • timconsidineT timconsidine

                                    @girish hugo is CLI for building and outputting the built files.
                                    Totally happy with building the site pages in terminal, rendering them in Hugo, using webserver to serve.
                                    I just want to do it all in one container, without CI/CD, cloning repos, pushing files.
                                    Maybe I will try a custom image based on Surfer.

                                    robiR Offline
                                    robiR Offline
                                    robi
                                    wrote on last edited by
                                    #25

                                    @timconsidine are there not hugo web front ends that might help?

                                    Conscious tech

                                    1 Reply Last reply
                                    0
                                    • timconsidineT timconsidine

                                      @girish hugo is CLI for building and outputting the built files.
                                      Totally happy with building the site pages in terminal, rendering them in Hugo, using webserver to serve.
                                      I just want to do it all in one container, without CI/CD, cloning repos, pushing files.
                                      Maybe I will try a custom image based on Surfer.

                                      girishG Offline
                                      girishG Offline
                                      girish
                                      Staff
                                      wrote on last edited by
                                      #26

                                      @timconsidine Depending on your use case:

                                      • Install surfer
                                      • Install hugo into /app/data of surfer - https://gohugo.io/installation/linux/
                                      • Then, setup a cron script via https://docs.cloudron.io/apps/#cron . That cron script periodically checks for changes in upstream, builds it locally and copies over to the surfer directory.
                                      robiR 1 Reply Last reply
                                      2
                                      • girishG girish

                                        @timconsidine Depending on your use case:

                                        • Install surfer
                                        • Install hugo into /app/data of surfer - https://gohugo.io/installation/linux/
                                        • Then, setup a cron script via https://docs.cloudron.io/apps/#cron . That cron script periodically checks for changes in upstream, builds it locally and copies over to the surfer directory.
                                        robiR Offline
                                        robiR Offline
                                        robi
                                        wrote on last edited by
                                        #27

                                        And you can mount Surfer app remotely via webdav!

                                        Conscious tech

                                        1 Reply Last reply
                                        1
                                        • timconsidineT Offline
                                          timconsidineT Offline
                                          timconsidine
                                          App Dev
                                          wrote on last edited by
                                          #28

                                          @girish thank you, I have taken a very similar but slightly different approach :

                                          • taken cloudron surfer as base app
                                          • tweaked Dockerfile to install hugo (into /app/data as suggested)
                                          • added a deploy.sh script for manual publishing (not via cron)

                                          Installed it as a custom app.
                                          Works nicely (as of course it should)
                                          Need to tidy it up before publishing a repo.

                                          So now I have Hugo bundled with Surfer, so all coding & building can be done within the container/app deployment.
                                          No need for CI/CD, and no need for git commits / push / fetch etc.
                                          Just open up the terminal from the app's settings panel.
                                          Single 'source of truth' accessible from any device.

                                          It might be a niche use case, but if someone really wants hugo deployed on Cloudron, it's available.

                                          1 Reply Last reply
                                          4
                                          • chetbakerC chetbaker referenced this topic on
                                          • jadudmJ jadudm referenced this topic on
                                          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