In the past few days, I’ve seen a number of people having trouble getting Lemmy set up on their own servers. That motivated me to create Lemmy-Easy-Deploy, a dead-simple solution to deploying Lemmy using Docker Compose under the hood.

To accommodate people new to Docker or self hosting, I’ve made it as simple as I possibly could. Edit the config file to specify your domain, then run the script. That’s it! No manual configuration is needed. Your self hosted Lemmy instance will be up and running in about a minute or less. Everything is taken care of for you. Random passwords are created for Lemmy’s microservices, and HTTPS is handled automatically by Caddy.

Updates are automatic too! Run the script again to detect and deploy updates to Lemmy automatically.

If you are an advanced user, plenty of config options are available. You can set this to compile Lemmy from source if you want, which is useful for trying out Release Candidate versions. You can also specify a Cloudflare API token, and if you do, HTTPS certificates will use the DNS challenge instead. This is helpful for Cloudflare proxy users, who can have issues with HTTPS certificates sometimes.

Try it out and let me know what you think!

https://github.com/ubergeek77/Lemmy-Easy-Deploy

  • neetly@lemmy.world
    link
    fedilink
    English
    arrow-up
    2
    ·
    1 year ago

    As someone who spent hours figuring out how to deploy through Ansible, how dare you /s But seriously thank you for putting in the work to make creating an instance more attainable for people.

  • orca@orcas.enjoying.yachts
    link
    fedilink
    English
    arrow-up
    2
    ·
    edit-2
    1 year ago

    This was the only tool that I was able to get running. I recommend it to anyone curious about running their own instance. I tried both the official Ansible and Docker instructions, and neither worked.

  • mfn@mfn.pub
    link
    fedilink
    English
    arrow-up
    2
    ·
    1 year ago

    After trying to do it with docker or ansible manually for hours and failing, this was soo helpful. So thank you.

  • Thief@lemmy.myserv.one
    link
    fedilink
    English
    arrow-up
    2
    ·
    edit-2
    1 year ago

    I used this and the developer is very helpful. Works great. Helped me even upgrade to 0.18.0.

  • Yolk@yiffit.net
    link
    fedilink
    English
    arrow-up
    1
    ·
    1 year ago

    Literally been thinking about this so thank you beautiful brained individual. Would you mind if I shouted this in the YSK group?

  • Manifish_Destiny@kbin.social
    link
    fedilink
    arrow-up
    1
    ·
    1 year ago

    Looks great my dude.
    If you expanded out the environment variables a ton, making it more customizable, (with default values in place of couse) this could appeal to a huge range of people.

  • SonyJunkie@lemmy.world
    link
    fedilink
    English
    arrow-up
    1
    ·
    1 year ago

    Hi @ubergeek77@lemmy.ubergeek77.chat

    I must be doing something wrong here because unlike many others I can’t seem to get this working! Please can you offer some advice?

    I have amended the config.env file to change the HOSTNAME, SITE NAME and ADMIN USER but left everything else the same.

    I then ran ./deploy.sh and everything seems to have worked because it presented me with the admin login credentials and basic instructions to shutdown and start the instance. I tried simply typing the IP address of the docker container in to a browser but that didn’t work and TBH I didn’t expect it to. I then typed the URL into the browser and I’m getting a “ERR_TOO_MANY_REDIRECTS” error message. I read through the trouble shooting on your Github but the only reference to too many redirects mentions a Cloudflare API token, I’m not using Cloudflare nut I am using nginx proxy manager to point my URL to the docker container.

    I hope some of this makes sense.

    • ubergeek77@lemmy.ubergeek77.chatOP
      link
      fedilink
      English
      arrow-up
      2
      ·
      1 year ago

      Hey there, please note that running behind a reverse proxy is not supported. You can do it if you want, but you are kinda on your own, sorry.

      If it helps, you will probably need to disable Caddy’s TLS in the config, and you will need to make sure that the request reaches Caddy via the correct host. You can’t reverse proxy directly to port 80 over an IP, it needs to think it’s coming from an actual domain.

      You can also check out my advanced configuration page to learn how to override the Caddyfile template and roll your own config that is more compatible for your use case.

      Good luck!

      • SonyJunkie@lemmy.world
        link
        fedilink
        English
        arrow-up
        1
        ·
        1 year ago

        Thank you so much for replying.

        I think this is above my skill level, but I will have a read through your advanced configuration page and see if I can understand it.

        Thanks again, but I think I’m going to need more than luck!! LOL

        • ubergeek77@lemmy.ubergeek77.chatOP
          link
          fedilink
          English
          arrow-up
          1
          ·
          1 year ago

          You’re welcome!

          If you’re not already, I recommend trying to host this on a cloud VPS service, such as Vultr, Linode, or DigitalOcean. This would give you a reliable, always online Lemmy instance, which means you won’t miss any federation data. Even a cheap $5 VPS instance would be enough to get you started, though a $10 would give you more breathing room.

          If you’re hosting at home, it’s generally not a good idea to do that, especially for an application like Lemmy. Most consumer grade network equipment at home might not be equipped to deal with the unrelenting 24/7 flood of data coming in due to federation. And if your power or internet ever goes out, you will be missing any comments, posts, or votes that were sent out during your downtime.

          • SonyJunkie@lemmy.world
            link
            fedilink
            English
            arrow-up
            1
            ·
            1 year ago

            Thank you again. Yeah, I’m trying this from home as opposed to a vps. It’s more as a learning exercise than a serious instance.

            I’m still going to try and getting it working behind my reverse proxy, like I say, as a learning experience.

  • sideone@lemmy.world
    link
    fedilink
    English
    arrow-up
    0
    ·
    edit-2
    1 year ago

    Hey @ubergeek77@lemmy.ubergeek77.chat, I’m trying this on an Aarm64 instance and the script says it only works on v0.17.4. Is there a plan to update to 0.18?

    EDIT: the script fails for 0.17.4 here:

    => ERROR [lemmy builder 6/7] RUN cargo build --release 1183.5s

    Build timer continues but CPU usage drops off. Any ideas where I’ve gone wrong?

    • ubergeek77@lemmy.ubergeek77.chatOP
      link
      fedilink
      English
      arrow-up
      1
      ·
      edit-2
      1 year ago

      Before this week, I would have told you no. But I have big plans for the 0.18.1 update.

      The Lemmy team has completely broken ARM support with seemingly no plan to support it again. They switched to a base Docker image that only supports x86_64. This is why your build fails. I still don’t understand why they would move from a multiarch image to an x86_64-only one.

      I’ve been working on this for about a week, and just yesterday I finished a GitHub Actions pipeline that builds multiarch images for x64/arm/arm64. I currently have successful builds for 0.18.1-rc.2. In a future update for my script, I will have it use these, that way ARM users don’t need to compile it anymore. I just ask for a little patience, I haven’t been able to do any work on Lemmy Easy Deploy since I’ve been working on this pipeline :)

      I also do want to qualify - don’t get your hopes up until you see it running for yourself. Ultimately, I am just a DevOps guy, not a Lemmy maintainer. I haven’t tested my ARM images yet, and while I did my best to get these to build properly, I can’t fix everything. If anything else breaks due to running on ARM, it will be up to the Lemmy team to fix those issues (which is not likely anytime soon, if their updated x86_64 Dockerfiles are any indication).

      But, fingers crossed everything goes smoothly! Keep an eye out for an update, I’m working hard on it, hopefully I can get it out in time for 0.18.1!


      EDIT:

      Putting my notes on this progress here:

      https://github.com/ubergeek77/Lemmy-Easy-Deploy/issues/17

    • ubergeek77@lemmy.ubergeek77.chatOP
      link
      fedilink
      English
      arrow-up
      0
      ·
      1 year ago

      Try again with the latest version of Lemmy Easy Deploy.

      I am now building multiarch images for 0.18.x, and my script will now default to my multiarch images, so there is no longer a need to build it yourself :)

  • JCreazy@midwest.social
    link
    fedilink
    English
    arrow-up
    0
    ·
    1 year ago

    I will definitely try this out. I already have my domain and SSL certificate. This will work on linode right?

    • ubergeek77@lemmy.ubergeek77.chatOP
      link
      fedilink
      English
      arrow-up
      0
      ·
      1 year ago

      It will work on pretty much anything that has a public IP and a domain pointing to that IP. The only thing that won’t work “out of the box” for most users is email, as most VPS providers block port 25. If you’ve requested access to port 25 and have been approved to use it, you can edit config.env to turn on the email service.

      As for your SSL certificate, unfortunately this does not support importing your own certificate. It’s made for beginners, after all :p

      But there should be no problems with Caddy simply requesting a new one for you!

      • b3nsn0w@pricefield.org
        link
        fedilink
        English
        arrow-up
        0
        ·
        1 year ago

        how well do those email servers work to begin with? i just flat out disabled the postfix relay on my instance and simply configured sendgrid, which works perfectly, no delays or spam folder issues (although i did have to disable a bunch of tracking bullshit). doing so with similar services has been my go-to card in freelance webdev, because getting other mail servers to trust you can be hard, so i’m interested in the experience people are having with those. (i’d much prefer to self-host email too, but providing a good experience is the primary goal)

        • ubergeek77@lemmy.ubergeek77.chatOP
          link
          fedilink
          English
          arrow-up
          1
          ·
          1 year ago

          I haven’t actually used the embedded postfix server at all, I keep mine disabled. I only include it because it’s “included” in the official Docker deployment files, and I try to keep this deployment as close to that as possible.

          I’m considering adding support for an external email service, as you mentioned, but I have nearly zero experience in using managed email services, and I’m not sure if non-technical users would be able to navigate the configuration of things I can’t do for them (i.e. on a web dashboard somewhere). And if I can’t do it for them, it means more issues for me, so I hesitate to add support for it at all.

          I’d love to hear your experience in setting up sendgrid and how easy that was. And the tracking stuff you mentioned as well.

          • b3nsn0w@pricefield.org
            link
            fedilink
            English
            arrow-up
            0
            ·
            1 year ago

            On the surface, setting up an external mail server is actually super easy. Pretty much every service supports SMTP, so all you need is to find your credentials (an endpoint, a username, and a password) and input that in your lemmy.hjson file, along with a sender address. There is a verification process with every email provider, you will usually have to set some DNS records to prove you own the domain you’re trying to send from, but once you do these two things, emails will just start flying out.

            The actual process tends to be a little more tedious though. Pretty much every mail provider wants to sell you on their specific super awesome API and only mentions SMTP as a footnote, for reasons that I can only parse as an attempted vendor lock-in. They also sometimes make the verification process difficult. SendGrid, for example, immediately redirects you to their “sender identities” which are more useful for their marketing automation tooling than they are for automated emails from a website, and you also have to dig a fair bit to find the SMTP credentials. (The endpoint is smtp.sendgrid.net, apikey on the username, and whatever your API key is for the password, you’ll need to set one of those up.) They also have a number of different tracking things that you’ll have to find and turn off in the UI (luckily all of them can be toggled in the same place), which would normally actually help you by providing you statistics about how many emails were opened and how many people clicked on links, but for the emails Lemmy sends, it’s useless and I didn’t want SendGrid to collect that data on my instance users, so I shut that off.

            Initially, I wanted to use Amazon SES, but they have an even more tedious setup: you have to talk to an actual human to have them turn it on for you, otherwise you’re stuck in sandbox mode and can only send email to verified receiver addresses. Their service works well though, I used it a lot in my freelancer days, and they do make it fairly straightforward to find the SMTP credentials, but the verification process can be slow.

            I also remember using Mailgun for some project ages ago, it was pretty much the same deal as all the others: you have to pry the SMTP details out of their docs, but once you do and you verify your stuff, it works well.

            Ultimately, I think the best you could do to help out users here is to provide them with documentation for a few of these services: exactly where to go, which buttons to click and whatnot. Or just stick to the embedded service for a bit, but the real issue there is the bounce rates from spammers. They made my instance send out like 60-70 verification emails for bogus addresses on gmail, yahoo, hotmail, and live.com on the first day I got federation working, and if you don’t already have a good reputation – which is what these third parties help you with – then you can easily get yourself blacklisted, either internally or externally.

            • ubergeek77@lemmy.ubergeek77.chatOP
              link
              fedilink
              English
              arrow-up
              0
              ·
              1 year ago

              I see. Thanks a lot for this!

              I really don’t have the capacity to support a bunch of different email services, so it sounds like the best I can do right now is make the SMTP settings accessible without also running the postfix server. So if someone wants to run their own email somewhere else, they can configure it. But otherwise, I’ll leave it to the user to figure out what happens after an email request leaves Lemmy.

              Does that sound fair, and like something you would have used? Essentially just an interface in config.env that puts the right SMTP address/credentials in lemmy.hjson.