Ugh - ok finally got it working (it runs on port 80 by default but the docs mention 8080) and then browsing to the homepage gets me:

Your Plane instance isn't ready yet Ask your Instance Admin to complete set-up first.

With nothing in the docs about this.

I just found out you need to go to /god-mode to finish the installation.

> it runs on port 80 by default but the docs mention 8080

No, it doesn't mention it:

> NGINX_PORT - This is default set to 80. Make sure the port you choose to use is not preoccupied. (e.g NGINX_PORT=8080)

The docs [1] are clear and concise. You just have to actually read it.

[1] https://docs.plane.so/self-hosting/docker-compose

They are concise, but they are not clear at all.

No, they’re pretty clear - see the quote in my previous comment - it’s absolutely clear about the usage of ports. And you should have courage to admit you were wrong when you were wrong.

Since they have a /pricing page it would seem their business is not to make it easy to self-host but in fact to make people pay for the cloud version instead.

The best way to test this hypothesis would be to send a pull request that makes the self-hosting docs clearer. If they accept it then their business does not rely on self-hosting being hard.

That's not a sufficient test, because when put under the gun there's no reason not to believe that a company playing those kinds of games won't take that pull request, temporarily improving the situation, and then simply make no effort to keep it up to date later. Addresses the temporary embarrassment, but not the underlying problem.

Mind, I don't think Plane's one of these. The open-source release seems comprehensive and the doc just seems not very good because the people who wrote it are experienced operators. But the claim being made isn't one that's easily put to rest except through the company in question committing to enthusiastic and comprehensive support that dispels doubts. (And, well--they chose that life!)

Yeah, my experience with working at a startup that did fairly explicitly rely on self-hosting being hard enough that people would pay us instead was that we definitely never had to go out of our way to make that be the case. Making self-hosting easy is a significant amount of continuously ongoing work and we simply underinvested in that. If someone did all that work for us one time we would have happily accepted it.

That's a sufficient test. It's the community's prerogative to keep it up to date later with further PRs. I don't expect anyone, whether a company or a volunteer, to do ongoing maintenance work on features that don't directly serve them. The thing I'm testing for is whether they'd block someone else contributing a change that doesn't serve that company or volunteer.

I was able to get it up and running within 5 minutes. Their self hosting version is as easy to set up as anything else self-hosted.

well some people like docker and some don't. If you are in the self-hosting realm, personally I think it is fair that the people doing it knows about DevOp or systemadmin, or else pay someone to host it for you.

I think the parent comment just wanted to say that since this project uses docker compose then it should be a lot simpler to get up and running. Actually running something in production would still require some degree of administration and monitoring based on your use case.

On their webpage it says that you can get started in 30 seconds with their hosted instance. Would be nice if it was as simple to get started with a locally hosted instance.

That’s certainly the incentive of a company who sells paid hosting.

I think it’s reasonable to provide as close to a one-line / one-action initial install, even for people who are experienced admins. (Those experienced folks can edit/tweak as they like, but having a basic “push this and something sensible happens” goes a long, long way to getting people to succeed in trying the product.)

to me, docker serves as documentation as well. I can see the dockerfile along with docker-compose file to see how it's being setup.

Of course it is fair. Why would we consider "fair" for an open source offering trying to entice new users?

I don't want a new project, I want to try self-hosting the software. If I am using it and liking it then certainly I would put time and effort into it. If it takes some time fiddling around with docker even to use, well, I have other projects to fiddle.

That goes for all self-hosted, but especially so for a project management tool. I'd be trialing it because I have projects I already need help managing. Adding one more is friction that would likely turn me away.

> If it takes some time fiddling around with docker even to use

Where did you get this from? You do not need to fiddle around with anything to have it working. The only thing that _probably_ requires "fiddling" is the nginx port - and you need to change it only if the default port is already in use. Is it really that difficult nowadays???

I want to know what configs are needed to get things stood up. I actually don't dockerize things right away. I setup my nginx to forward to different machines in my network. When I settle on a home for things, I may (finally) get around to whipping up a Dockerfile.

Not everything needs to be enterprise whizbang out the gate.

A docker compose file and the corresponding Dockerfiles should tell you all you need to self host as well.

To be fair, 'try the platform out' to me includes getting an understanding of dependencies and configuration. Docker is useful for a lot of things, but even if I want to use containerization in prod, I'd prefer to build my own containers rather than being dependent on someone else's runtime environment, so getting hands-on with the setup is important to me.

If the goal is just to test the application functionality, a demo site that's already set up and publicly accessible would be much easier than having to deploy a Docker container.

In terms of Nginx, using it to handle web server functionality, and especially encryption, while acting as a gateway into your containerized apps is a pretty bog-standard approach, and makes for good separation of concerns. I don't see much value in having that stuff implemented separately within each application and creating more config complexity for sysadmin work.

If you just follow the documentation [1], it "just works". I just installed it on my machine, everything was up and running within 3-5 minutes.

They even wrote a setup script that saves you from the mind-boggling complexity of docker, giving you a simple menu where you only have to read the items and press a key. If you don't know which key to press, the readme [1] is very helpful. The only place where you will have to "fiddle" with the environment files is to change the default port from 80 to another. And if you're not ready for that, or not skilled enough to understand what that means and why you might need to do it - you're not ready for self-hosting and should take a step back and learn the basics of OS administration.

Oh, and they mention nginx because this software uses nginx inside a container. Hope that answers your question.

[1] https://docs.plane.so/self-hosting/docker-compose