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

  • 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.

  • neetly@lemmy.world
    link
    fedilink
    English
    arrow-up
    1
    ·
    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.

  • 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?

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

    Hi @[email protected]

    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.

  • JCreazy@midwest.social
    link
    fedilink
    English
    arrow-up
    1
    ·
    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!

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

          I’m not sure what you mean? Most people are just self hosting instances for themselves, where email isn’t needed. My instance doesn’t have an email service.

          And as I explained, if email is something you want, I have an advanced option for this. It’s not the default because there is not a public VPS host out there that lets you use port 25 without special approval.

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

            Email config is needed for lost passwords. It’s also needed for account verification, if you run without verification you could easily become a place for people to abuse other servers and get yourself defederated.

            Many web hosts have poisoned mail IPs, so setting up with a smtp config to a well known site server is required if you want your emails to be delivered.

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

              And that is why I don’t advertise this as supporting email out of the box, and why it’s an advanced option without any support from me. The embedded postfix server is part of the official Docker Compose deployment from upstream Lemmy, and it’s part of the officially supported Ansible deployment too. Those deployment methods are what this is modeled after. That is as far as I go on email support. If upstream Lemmy started including some automatic AWS SNS configuration, I would adopt it, but they have not done so.

              Everyone who has reported success to me so far are running single user instances for themselves. That is my target audience, and for that audience (and myself), email is not even close to being a hard requirement.

              However, if you would like to improve this script by adding support for more robust and secure email systems, I would be happy if you submitted a PR to do just that :)

            • 8565@lemmy.quad442.com
              link
              fedilink
              English
              arrow-up
              0
              ·
              1 year ago

              Don’t lose your passwords and leave closed registration so only people you actually want on your instance are on it. You absolutely do not need email.

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

                You can’t have the checkbox for federation and private, the server will crash and tell you that in the lemmy log. Had that happen when I did thy to setup without email the first time.

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

    You kind Sir/Lady/Gentleperson are making the fediverse a better place with this help. Thanks a bunch, gonna definitely ease my attempts at eventually self-hosting!

  • ipkpjersi@lemmy.one
    link
    fedilink
    English
    arrow-up
    1
    ·
    1 year ago

    Wow, I’ll definitely look into this, thanks! Even if I don’t use it, it still may be useful just reading through it.

  • untilyouarrived@lemmy.gtfo.social
    link
    fedilink
    English
    arrow-up
    0
    ·
    1 year ago

    I’m relatively competent installing server software, but the Lemmy instructions completely flummoxed me. Their docker instructions just don’t work.

    I ended up using the ansible docker scripts and filling out the blanks because I’m unfamiliar with ansible.

    If this is as good as it sounds, you’re doing everyone a massive favour.

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

    Exploring Go High Level:

    1. What’s the Enthusiasm About?
      Hello there! Are you familiar with Go High Level? If not, let’s break it down. Imagine managing multiple apps for marketing. Sounds busy. That’s where Go High Level comes in. It’s like that friend who has a solution for everything. Whether you are working on creating an outstanding sales funnel or sending out an email campaign, this platform has your back. The best part? They let you test drive everything with a 14-day free trial. It’s like trying out a new car but for your business. And if you ever need assistance, their support team is just a click away. Pretty exciting, huh?

    2. So, How Much Does It Cost?
      Alright, let’s talk about the financial side. Go High Level offers 3 main plans. The Agency Starter Plan is perfect if you’re just starting or have a small business. It’s loaded with all the essential tools, and it’s quite cost-effective. But if you’re looking to scale up, the Agency Unlimited Plan is your best choice. It’s like the VIP pass at a concert, giving you access to everything without any limitations. Not sure about committing? Remember that 14-day free trial I mentioned? It’s a great way to give it a try without any obligations. Lastly, they offer a Pro plan that includes “SaaS mode,” where you can white label the product under your brand. Fantastic!

    3. Why Everyone’s Raving About It:
      In a world full of sophisticated digital tools, Go High Level is like that all-in-one Swiss Army knife. There’s no need to switch between apps because it has everything under one roof. Whether you’re a newcomer or an experienced marketer, it’s super user-friendly. It’s not just about launching impressive campaigns; they ensure you understand their performance with top-notch analytics. There’s even a white-label feature for marketing agencies, so you can add your brand and impress your clients.

    Here is a link to their 14-day free trial:
    https://www.gohighlevel.com/?fp_ref=get-started-now.

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

    Exploring Go High Level:

    What’s the Enthusiasm About?
    Hello there! Are you familiar with Go High Level? If not, let’s break it down. Imagine managing multiple apps for marketing. Sounds busy. That’s where Go High Level comes in. It’s like that friend who has a solution for everything. Whether you are working on creating an outstanding sales funnel or sending out an email campaign, this platform has your back. The best part? They let you test drive everything with a 14-day free trial. It’s like trying out a new car but for your business. And if you ever need assistance, their support team is just a click away. Pretty exciting, huh?

    So, How Much Does It Cost?
    Alright, let’s talk about the financial side. Go High Level offers 3 main plans. The Agency Starter Plan is perfect if you’re just starting or have a small business. It’s loaded with all the essential tools, and it’s quite cost-effective. But if you’re looking to scale up, the Agency Unlimited Plan is your best choice. It’s like the VIP pass at a concert, giving you access to everything without any limitations. Not sure about committing? Remember that 14-day free trial I mentioned? It’s a great way to give it a try without any obligations. Lastly, they offer a Pro plan that includes “SaaS mode,” where you can white label the product under your brand. Fantastic!

    Why Everyone’s Raving About It:
    In a world full of sophisticated digital tools, Go High Level is like that all-in-one Swiss Army knife. There’s no need to switch between apps because it has everything under one roof. Whether you’re a newcomer or an experienced marketer, it’s super user-friendly. It’s not just about launching impressive campaigns; they ensure you understand their performance with top-notch analytics. There’s even a white-label feature for marketing agencies, so you can add your brand and impress your clients.

    Here is a link to their 14-day free trial:
    https://www.gohighlevel.com/?fp_ref=get-started-now.

  • redcalcium@c.calciumlabs.com
    link
    fedilink
    English
    arrow-up
    0
    ·
    1 year ago

    Nice! Looks like it even has update checker as well. Is there any reason why pictrs is not included in the update checker and hardcoded to version 0.3.1?

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

      The Lemmy maintainers themselves seem to lock it at 0.3.1, and I wanted to maintain parity with their deployment. I know pictrs is up to at least 0.3.3, and has a release candidate for 0.4, but upstream Lemmy uses 0.3.1 for whatever reason, so that’s why I lock it there.

      It’s excluded from the update checker because I don’t have a stable way to check what version upstream is using. The Lemmy update checker just checks to see what the latest tag on LemmyNet/lemmy is. I could try and pull the latest Gitea tag for pictrs, but since upstream Lemmy isn’t using the latest version, that’s not really an option as something might break.

      I considered trying to parse their docker-compose.yml file to see what version they use, but they seem to be restructuring their docker folder right now. The folder in main is completely different from the one tagged 0.17.4. If I assume a certain directory path for that file for every version after this, but they move it, my script will break. Sadly, until their Docker deployment files seem like they’re going unchanged for a good few versions, I’ll have to do it manually for now.

      • redcalcium@c.calciumlabs.com
        link
        fedilink
        English
        arrow-up
        1
        ·
        edit-2
        1 year ago

        I see, looks like it’s a correct decision to me. Let the Lemmy developers worry about which version of pictrs to use themselves.